讲师中心 微信公众号
AI工具推荐 视频效率加速

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

星萱小哥_5817

星萱小哥_5817

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

|

710人浏览过

|

来源于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 标签名(如 div、section)。

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

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

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

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

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

Convert Markdown To HTML And PDF - Markdown和HTML、PDF互转
Convert Markdown To HTML And PDF - Markdown和HTML、PDF互转

实现 Markdown↔ HTML 互转,支持导出 PDF,用于用户请求的文档格式转换。

下载
  • constructor():仅用于初始化实例属性、绑定方法、创建 Shadow DOM(此时不能访问 this.shadowRoot 或 this.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 写了 <my-counter><span>1</span></my-counter>
  console.log(getComputedStyle(this).color); // 可能是空字符串或默认值
}

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

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

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

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

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

相关文章

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

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

下载

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

热门AI工具

更多
Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

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

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

549

2023.09.22

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

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

1698

2024.03.01

typedef和define区别
typedef和define区别

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

313

2023.09.26

define的用法
define的用法

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

619

2023.10.11

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

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

3568

2023.11.20

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

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

6541

2024.08.14

promise的用法
promise的用法

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

4700

2023.10.12

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

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

4423

2023.10.12

Uvicorn 报错与问题解决教程
Uvicorn 报错与问题解决教程

本专题汇总了Uvicorn服务器常见问题与报错解决的教程合集,涵盖启动失败、端口占用、模块导入错误、事件循环冲突及热重载失效等典型故障的排查思路。同时整理了多进程与Worker配置、SSL/HTTPS证书报错、跨域与代理配置等实战解决方案,助你快速定位并解决Uvicorn运行中的各类问题。

0

2026.11.02

热门下载

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

精品课程

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

共14课时 | 1.6万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn