JavaScriptWebComponents是什么?如何自定义HTML元素?
时间:2026-01-09 08:22:35 141浏览 收藏
偷偷努力,悄无声息地变强,然后惊艳所有人!哈哈,小伙伴们又来学习啦~今天我将给大家介绍《JavaScript Web Components是什么?如何自定义HTML元素?》,这篇文章主要会讲到等等知识点,不知道大家对其都有多少了解,下面我们就一起来看一吧!当然,非常希望大家能多多评论,给出合理的建议,我们一起学习,一起进步!
Web Components 是浏览器原生支持的可复用、封装良好的自定义 HTML 元素,核心包括 customElements、HTMLElement 和 Shadow DOM;需继承 HTMLElement、含短横线命名、调用 customElements.define() 注册,并用 attachShadow 隔离样式与事件。

Web Components 是什么?它不是框架,而是浏览器原生能力
Web Components 是一组浏览器内置的 API,让你能创建可复用、封装良好的自定义 HTML 元素。它不依赖 React 或 Vue,也不需要构建工具——只要现代浏览器(Chrome 67+、Firefox 63+、Safari 16.4+、Edge 79+)就支持。核心是三个接口:customElements、HTMLElement 和 Shadow DOM。其中 customElements.define() 是注册自定义元素的唯一入口,没调用它,元素就不会被识别。
如何用 class 定义并注册一个自定义元素?
必须继承 HTMLElement,且类名中必须包含短横线(-),比如 my-button 合法,MyButton 或 mybutton 会报错 Failed to execute 'define' on 'CustomElementRegistry': The name provided ('mybutton') is not a valid custom element name。
class MyButton extends HTMLElement {
constructor() {
super();
// 必须调用 super(),否则 this 未初始化
const shadow = this.attachShadow({ mode: 'open' });
const button = document.createElement('button');
button.textContent = this.getAttribute('label') || 'Click me';
button.addEventListener('click', () => this.dispatchEvent(new Event('click', { bubbles: true })));
shadow.appendChild(button);
}
}
customElements.define('my-button', MyButton); // 名字必须小写+短横线
注册后就能直接在 HTML 中使用:。注意:注册必须在元素被解析前完成,否则会触发 Unknown custom element 警告(尤其在动态插入时)。
为什么 Shadow DOM 是关键?它隔离了样式和事件
不加 attachShadow(),你的自定义元素只是个空壳,样式和脚本会泄漏进全局作用域,和普通 div 没区别。加了之后,内部结构、CSS、事件默认不会穿透到宿主文档,也不会被宿主样式污染。常见误区:
mode: 'closed'会让shadowRoot不可访问(连this.shadowRoot都是null),调试困难,除非有强封装需求,否则用'open'- 想让宿主 CSS 影响内部元素?不行——得用
::slotted或 CSS 自定义属性(var(--color))透传 - 子元素事件默认不冒泡出 Shadow DOM,需手动设
{ bubbles: true }才能在外层监听
生命周期回调里该做什么?别在 connectedCallback 里重复初始化
四个标准回调:constructor、connectedCallback、disconnectedCallback、attributeChangedCallback。重点:
constructor:只做最小初始化(如super()、attachShadow、绑定事件),不能访问this.innerHTML或查询父节点connectedCallback:元素被插入 DOM 时触发,适合发起网络请求、启动定时器;但可能被多次调用(移入移出),记得用if (!this._initialized)防重入attributeChangedCallback:需在observedAttributes静态 getter 中声明监听哪些属性,比如static get observedAttributes() { return ['disabled']; },否则不会触发
复杂状态管理或异步渲染逻辑,建议封装成独立方法,避免把所有逻辑堆在回调里。
理论要掌握,实操不能落!以上关于《JavaScriptWebComponents是什么?如何自定义HTML元素?》的详细介绍,大家都掌握了吧!如果想要继续提升自己的能力,那么就来关注golang学习网公众号吧!
-
502 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
310 收藏
-
300 收藏
-
346 收藏
-
349 收藏
-
221 收藏
-
273 收藏
-
188 收藏
-
199 收藏
-
415 收藏
-
155 收藏
-
217 收藏
-
334 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习