Web Components 由 Custom Elements、Shadow dom 和 html Templates 组成,1. 通过 customElements.define 定义自定义标签;2. Shadow DOM 实现样式与结构隔离,避免冲突;3. Template 标签声明可复用结构,延迟渲染;4. 支持属性监听与生命周期回调,如 connectedCallback 与 attributeChangedCallback,实现响应式更新;组合三者可构建高内聚、可复用、跨框架的前端组件,适用于现代 Web 开发。

Web Components 是一套让开发者创建可复用、独立封装的自定义 HTML 元素的技术,它原生支持浏览器,无需依赖框架。javaScript Web Components 的核心由三项技术组成:Custom Elements、Shadow DOM 和 HTML Templates。结合这三项技术,可以实现真正组件化的前端开发。
1. Custom Elements(自定义元素)
Custom Elements 允许你定义自己的 HTML 标签。通过 customElements.define() 方法注册一个类继承自 HTMLElement 的组件类。
例如,创建一个名为 <my-card> 的卡片组件:
class MyCard extends HTMLElement { constructor() { super(); this.innerHTML = `
${this.getAttribute(‘title’) || ‘默认标题’}
`; } } customElements.define(‘my-card’, MyCard);
使用时只需在 HTML 中写:<my-card title=”个人信息”>这里是内容</my-card>。
立即学习“Java免费学习笔记(深入)”;
2. Shadow DOM(影子 DOM)
Shadow DOM 提供了真正的样式和结构隔离。将组件内部的 DOM 与页面其他部分隔离开,避免样式冲突。
在构造函数中调用 this.attachShadow({ mode: ‘open’ }) 创建 Shadow Root,并将模板插入其中。
class MyButton extends HTMLElement { constructor() { super(); const shadow = this.attachShadow({ mode: ‘open’ }); shadow.innerHTML = `
`; } } customElements.define(‘my-button’, MyButton);
这样按钮的样式不会影响外部,也不会被外部 css 污染。
3. HTML Templates(模板标签)
使用 <template> 标签定义可复用的 HTML 结构,它不会在页面中渲染,直到被 javascript 实例化。
例如:
<template id=”card-template”> <style> .card { border: 1px solid #ddd; padding: 16px; border-radius: 8px; } </style> <div class=”card”> <h3><slot name=”title”></slot></h3> <p><slot name=”content”></slot></p> </div> </template>
在自定义元素中克隆并插入模板:
const template = document.getElementById(‘card-template’); const clone = template.content.clonenode(true); this.shadowRoot.appendChild(clone);
4. 属性与生命周期回调
Web Components 支持监听属性变化,并提供生命周期钩子:
- connectedCallback:元素插入 DOM 时触发
- disconnectedCallback:元素从 DOM 移除时触发
- attributeChangedCallback:监控属性变化
- observedAttributes:指定需要监听的属性
示例:响应主题切换
Static get observedAttributes() { return [‘theme’]; } attributeChangedCallback(name, oldValue, newValue) { if (name === ‘theme’) { this.shadowRoot.querySelector(‘.card’).style.backgroundColor = newValue === ‘dark’ ? ‘#333’ : ‘#fff’; } }
基本上就这些。通过组合 Custom Elements、Shadow DOM 和 Template,你可以构建出高内聚、低耦合的 Web 组件,适用于任何现代前端项目,无论是原生 js 还是集成到 react、vue 中。关键是封装良好、样式隔离、可复用性强。不复杂但容易忽略细节,比如 slot 使用、属性监听和 Shadow Root 的管理。


