Web Components 是浏览器原生支持的可复用、封装良好的自定义 HTML 元素标准,由 Custom Elements、Shadow DOM 和 HTML Templates 三部分组成,不依赖框架,适用于跨技术栈的基础组件开发。

Web Components 是一套浏览器原生支持的技术标准,让你能创建可复用、封装良好的自定义 HTML 元素。它不是框架,不依赖 React 或 Vue,而是直接基于 HTML、CSS 和 JavaScript 构建的“真正”的组件。
核心三部分:Custom Elements + Shadow DOM + HTML Templates
Web Components 由三个关键技术组成,缺一不可:
Custom Elements:定义新标签名(如 ),并绑定 JS 类行为 Shadow DOM:为组件提供样式和结构的私有作用域,避免全局污染 HTML Templates():声明式地定义组件结构,内容默认不渲染,适合复用
从零创建一个自定义按钮元素
下面是一个完整、可运行的示例,实现带点击计数的 :
class CounterButton extends HTMLElement { constructor() { super(); // 创建 Shadow DOM(闭合模式,外部无法访问内部节点) const shadow = this.attachShadow({ mode: 'closed' }); // 定义模板结构(也可用 innerHTML,但 template 更语义化) const template = document.createElement('template'); template.innerHTML = ` button { background: #007bff; color: white; border: none; padding: 8px 16px; border-radius: 4px; cursor: pointer; } button:hover { background: #0056b3; } Count: 0 `; // 克隆模板内容并挂载到 shadow root shadow.appendChild(template.content.cloneNode(true)); // 初始化计数器状态 this.count = 0; this.$countEl = shadow.getElementById('count'); this.$button = shadow.querySelector('button'); // 绑定事件 this.$button.addEventListener('click', () => { this.count++; this.$countEl.textContent = this.count; // 可选:派发自定义事件供外部监听 this.dispatchEvent(new CustomEvent('count-change', { detail: this.count })); }); } // 属性变更时触发(需配合 static observedAttributes) attributeChangedCallback(name, oldValue, newValue) { if (name === 'disabled' && newValue !== null) { this.$button.disabled = true; } else if (name === 'disabled' && newValue === null) { this.$button.disabled = false; } } // 声明要监听的属性(必须是字符串数组) static get observedAttributes() { return ['disabled']; }}// 向浏览器注册自定义元素(标签名必须含短横线)customElements.define('counter-button', CounterButton);
使用方式就像普通 HTML 元素一样:
立即学习“Java免费学习笔记(深入)”;
Start counting
关键注意事项和实用技巧
命名规则强制要求:自定义标签名必须包含短横线(-),如 合法, 会报错 生命周期钩子很重要:除了 constructor 和 attributeChangedCallback,还有 connectedCallback(插入 DOM 时)、disconnectedCallback(移出 DOM 时),适合做资源初始化/清理 Slot 是内容分发核心: 让你把外部传入的内容(如文本、子元素)“插入”到 Shadow DOM 中指定位置,实现类似 Vue 的 或 React 的 children 样式隔离靠 Shadow DOM:外部 CSS 默认无法穿透到 shadow 内部,内部样式也不会泄漏出去;如需主题支持,可用 CSS 自定义属性(--primary-color)配合 :host 选择器
是否需要框架?什么时候该用 Web Components?
Web Components 适合构建跨框架复用的基础组件库(比如设计系统里的按钮、输入框、模态框)。如果你的项目已用 React/Vue,没必要重写全部逻辑——但可以封装成 Web Component 供其他技术栈调用。它天然支持渐进增强,老浏览器可通过 @webcomponents/webcomponentsjs polyfill 回退。
不复杂但容易忽略细节,掌握 Custom Elements + Shadow DOM 就能写出真正解耦、可移植的前端组件。
以上就是javascript Web Components是什么_如何创建自定义HTML元素?的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1544182.html
微信扫一扫
支付宝扫一扫