0

0

javascript web组件如何创建_自定义元素的生命周期有哪些【教程】

紅蓮之龍

紅蓮之龍

发布时间:2026-01-29 15:38:02

|

670人浏览过

|

来源于php中文网

原创

自定义元素需继承HTMLElement且名称含短横线,通过customElements.define()注册;constructor初始化属性,connectedCallback在插入文档时触发但DOM未就绪,attributeChangedCallback捕获声明属性的变化,disconnectedCallback用于清理。

javascript web组件如何创建_自定义元素的生命周期有哪些【教程】

自定义元素(Custom Elements)不是“需要教程才能用”的黑箱,而是浏览器原生支持的 Web Components 核心能力;关键在于理解 customElements.define() 的约束和生命周期回调的真实触发时机——错把 connectedCallback 当作“渲染完成”是绝大多数人踩坑的起点。

如何正确注册一个自定义元素

必须继承 HTMLElement,且类名中必须含短横线(-),否则浏览器直接抛 DOMException: Failed to execute 'define' on 'CustomElementRegistry': The name "mybutton" is not a valid custom element name。不能用纯字母命名,也不能用已知 HTML 标签名(如 divsection)。

注册前必须确保类已声明,且不能重复注册同名元素(会报 NotSupportedError):

class MyCounter extends HTMLElement {
  constructor() {
    super(); // 必须调用
    this.count = 0;
  }
}
customElements.define('my-counter', MyCounter); // ✅ 合法名称
// customElements.define('mycounter', MyCounter); // ❌ 报错

四个标准生命周期回调分别在什么时候触发

它们不是按“创建→插入→更新→移除”顺序线性执行,也不保证 DOM 已就绪或样式已计算。每个回调只负责它明确承诺的事:

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

QIMI奇觅
QIMI奇觅

美图推出的游戏行业广告AI制作与投放一体化平台

下载
  • constructor():仅用于初始化实例属性、绑定方法、创建 Shadow DOM(此时不能访问 this.shadowRootthis.parentNode,更不能操作子节点
  • connectedCallback():元素被插入任意文档(包括 document.adoptNode()innerHTML 插入)时触发;但此时子元素可能尚未 upgrade,且 CSS 可能未生效
  • disconnectedCallback():元素从文档中移除时触发;适合清理事件监听器、定时器;不保证该元素之后不会被重新插入
  • attributeChangedCallback(attrName, oldValue, newValue):仅当该属性在 observedAttributes 静态 getter 中声明过,且通过 setAttribute() 或属性赋值(如 el.foo = 'bar')变更时才触发;初始属性值(HTML 中写的)也会触发一次,但 oldValue 是 null

为什么 connectedCallback 里拿不到子节点或样式?

因为它是同步触发的,早于浏览器布局计算和子组件 upgrade。常见误操作是:

connectedCallback() {
  console.log(this.children.length); // 很可能为 0,即使 HTML 写了 1
  console.log(getComputedStyle(this).color); // 可能是空字符串或默认值
}

若需等子节点就绪,可用 requestAnimationFrame() 延迟一帧(适用于简单场景),或监听 slotchange 事件(适用于含 的 Shadow DOM);若需等所有自定义子元素 upgrade 完成,应使用 customElements.whenDefined('xxx') + Promise.all() 组合判断。

升级(upgrade)机制容易被忽略的关键点

已存在 DOM 中的元素,在 customElements.define() 调用后会立即 upgrade(即执行 constructorconnectedCallback)。这意味着:

  • HTML 中先写 ,再加载并 define 类 —— count 属性会在 upgrade 时触发 attributeChangedCallback
  • 如果在 constructor 里读 this.getAttribute('count'),会得到 null(因为 attribute 还没被解析进属性),必须靠 attributeChangedCallback 捕获
  • Shadow DOM 中的 默认是异步分发的,slot.assignedNodes()connectedCallback 里调用仍可能为空

真正可靠的“组件完全就绪”信号,往往得自己组合:upgrade + attribute change + slotchange + rAF,没有银弹。

相关文章

java速学教程(入门到精通)
java速学教程(入门到精通)

java怎么学习?java怎么入门?java在哪学?java怎么学才快?不用担心,这里为大家提供了java速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

236

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

458

2024.03.01

typedef和define区别
typedef和define区别

typedef和define区别在类型检查、作用范围、可读性、错误处理和内存占用等。本专题为大家提供typedef和define相关的文章、下载、课程内容,供大家免费下载体验。

109

2023.09.26

define的用法
define的用法

define用法:1、定义常量;2、定义函数宏:3、定义条件编译;4、定义多行宏。更多关于define的用法的内容,大家可以阅读本专题下的文章。

338

2023.10.11

counta和count的区别
counta和count的区别

Count函数用于计算指定范围内数字的个数,而CountA函数用于计算指定范围内非空单元格的个数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

198

2023.11.20

DOM是什么意思
DOM是什么意思

dom的英文全称是documentobjectmodel,表示文件对象模型,是w3c组织推荐的处理可扩展置标语言的标准编程接口;dom是html文档的内存中对象表示,它提供了使用javascript与网页交互的方式。想了解更多的相关内容,可以阅读本专题下面的文章。

3342

2024.08.14

promise的用法
promise的用法

“promise” 是一种用于处理异步操作的编程概念,它可以用来表示一个异步操作的最终结果。Promise 对象有三种状态:pending(进行中)、fulfilled(已成功)和 rejected(已失败)。Promise的用法主要包括构造函数、实例方法(then、catch、finally)和状态转换。

306

2023.10.12

html文本框类型介绍
html文本框类型介绍

html文本框类型有单行文本框、密码文本框、数字文本框、日期文本框、时间文本框、文件上传文本框、多行文本框等等。详细介绍:1、单行文本框是最常见的文本框类型,用于接受单行文本输入,用户可以在文本框中输入任意文本,例如用户名、密码、电子邮件地址等;2、密码文本框用于接受密码输入,用户在输入密码时,文本框中的内容会被隐藏,以保护用户的隐私;3、数字文本框等等。

406

2023.10.12

java入门学习合集
java入门学习合集

本专题整合了java入门学习指南、初学者项目实战、入门到精通等等内容,阅读专题下面的文章了解更多详细学习方法。

1

2026.01.29

热门下载

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

精品课程

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

共14课时 | 0.8万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.1万人学习

CSS教程
CSS教程

共754课时 | 24.8万人学习

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

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