0

0

掌握HTML自定义内置元素:深入理解is属性的正确用法

心靈之曲

心靈之曲

发布时间:2025-10-28 11:36:06

|

493人浏览过

|

来源于php中文网

原创

掌握HTML自定义内置元素:深入理解is属性的正确用法

本文旨在详细阐述html自定义内置元素(customized built-in elements)的正确创建与使用方式,重点解析在扩展原生html标签时,为何必须借助`is`属性而非直接使用自定义标签名,并提供具体的代码示例,以确保自定义元素能正确继承并访问原生元素的属性和方法。

理解自定义内置元素

Web Components规范允许开发者创建两种类型的自定义元素:

  1. 自主自定义元素 (Autonomous Custom Elements):这类元素完全独立,拥有自己的标签名(必须包含连字符,例如 )。它们不继承任何现有HTML元素,从HTMLElement基类派生。
  2. 自定义内置元素 (Customized Built-in Elements):这类元素扩展了现有的HTML元素(例如 HTMLCanvasElement, HTMLParagraphElement 等),并继承了其所有属性和方法。它们在注册时需要指定所扩展的原生元素,并且在使用时必须通过原生元素的标签名配合is属性来实例化。

问题中遇到的width属性未定义的情况,正是由于混淆了这两种自定义元素的使用方式。当一个自定义元素旨在扩展例如canvas>这样的原生元素时,它属于自定义内置元素。

is属性的核心作用

对于自定义内置元素,其核心机制在于is属性。MDN Web Docs明确指出,要创建和使用定制的内置元素,必须指定它们所扩展的元素,并且在使用时,要通过书写基础元素标签并指定自定义元素名称在is属性中。例如,

word-count"> 或 document.createElement("p", { is: "word-count" })。

这意味着,即使您定义了一个名为render-area的自定义元素来扩展,您也不能直接在HTML中使用标签。这样做,浏览器会将其解析为一个自主自定义元素,而不是一个继承了所有特性的定制版本。因此,诸如width、height等属于原生元素的属性,将无法被正确识别和访问。

立即学习前端免费学习笔记(深入)”;

正确实现与使用自定义内置元素

让我们通过一个具体的例子来演示如何正确地创建一个扩展HTMLCanvasElement的自定义内置元素,并确保其原生属性如width能够被正确访问。

1. 定义自定义元素类

首先,我们需要定义一个JavaScript类,该类继承自目标原生HTML元素(在此例中为HTMLCanvasElement)。

class Renderer extends HTMLCanvasElement {
  constructor() {
    // 必须调用 super() 来正确初始化继承的实例
    super();
    // 可以在这里添加自定义的初始化逻辑
    console.log('Renderer custom element initialized.');
  }

  // 可以在这里添加自定义方法或生命周期回调
  connectedCallback() {
    console.log('Renderer connected to DOM.');
    // 此时,原生 canvas 属性如 width, height 应该已经可用
    console.log(`Canvas width from connectedCallback: ${this.width}`);
  }
}

2. 注册自定义元素

使用customElements.define()方法注册自定义元素。关键在于,对于自定义内置元素,需要提供一个配置对象,其中包含extends属性,指明所扩展的原生标签名。

千问APP
千问APP

阿里最强大模型官方AI助手

下载
// 注册名为 "render-area" 的自定义元素,并指定它扩展 'canvas' 元素
customElements.define("render-area", Renderer, { extends: 'canvas' });

3. 在HTML中正确使用自定义元素

这是最容易出错的环节。由于render-area是一个自定义内置元素,它扩展了,因此在HTML中必须使用标签,并通过is="render-area"属性来指定其为我们定义的自定义版本。

错误的使用方式(导致原生属性无法访问):



在这种情况下,document.querySelector('render-area').width很可能会输出undefined,因为浏览器将视为一个独立的、不具备原生属性的元素。

正确的实现方式:



在这个正确的示例中,document.querySelector('[is=render-area]')会找到那个被定制的元素,并且width属性将正确地返回500。

完整示例代码




    
    
    Customized Built-in Element Tutorial
    



    

自定义内置元素:`is`属性的正确用法

请观察控制台输出,了解 `width` 属性的访问情况。

注意事项与总结

  • 区分类型:始终明确您是在创建自主自定义元素(完全新的标签)还是自定义内置元素(扩展现有标签)。
  • is属性的强制性:对于自定义内置元素,is属性是不可或缺的。它告诉浏览器将一个标准HTML元素视为一个特定自定义元素的实例。
  • 属性继承:通过is属性正确实例化后,自定义内置元素将继承所有原生元素的属性、方法和事件,从而能够无缝地利用原生元素的功能。
  • DOM查询:在查询自定义内置元素时,应使用其原生标签名结合is属性进行选择,例如 document.querySelector('canvas[is="render-area"]')。

理解并正确应用is属性是有效利用自定义内置元素、构建功能丰富且符合标准Web组件的关键。通过遵循上述指南,开发者可以避免常见的陷阱,确保自定义元素能够充分发挥其继承自原生元素的强大能力。

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

556

2023.06.20

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

374

2023.07.04

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

733

2023.07.04

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

477

2023.09.01

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

414

2023.09.04

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

991

2023.09.04

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

658

2023.09.12

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

553

2023.09.20

java用途介绍
java用途介绍

本专题整合了java用途功能相关介绍,阅读专题下面的文章了解更多详细内容。

0

2026.01.19

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
React 教程
React 教程

共58课时 | 3.8万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 2.3万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 2.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号