自定义元素命名必须含短横线,如user-card;需继承htmlElement、声明observedAttributes、实现attributeChangedCallback,并用customElements.define()注册。

Web组件是一套浏览器原生支持的前端技术标准,核心包括自定义元素(Custom Elements)、影子dom(Shadow DOM)和HTML模板(<template></template>)。它让开发者能封装可复用、样式与逻辑隔离的HTML标签,比如 <my-button></my-button> 或 <date-picker></date-picker>,无需框架也能实现“组件化”。
自定义元素必须满足哪些命名规则?
浏览器强制要求自定义元素名中必须包含短横线(-),例如 user-card、loading-spinner。这是为了确保不与现有或未来HTML标准标签冲突。像 mydiv 或 Button 这样的名字会直接报错,无法注册。
用 javaScript 创建自定义元素的三步法
现代方式基于 es6 类 + customElements.define(),步骤清晰:
- 定义一个继承自
HTMLElement的类,可添加生命周期钩子(如connectedCallback、disconnectedCallback) - 在类中封装属性响应(通过
Static get observedAttributes()和attributeChangedCallback) - 调用
customElements.define('标签名', 类名)完成注册
示例:一个带文字内容的简单卡片
立即学习“Java免费学习笔记(深入)”;
一款多用途的企业软件前端HTML模板。IT软件服务公司网站响应式单页模板。基于CSS、JS、HTML模块化原则创建的。如果您的站点不需要所有元素,那么可以轻松地删除不必要的组件。模板的代码干净,友好,注释良好。这使得编辑和自定义模板变得很容易。
350
class InfoCard extends HTMLElement { constructor() { super(); this.attachShadow({ mode: 'open' }); this.shadowRoot.innerHTML = ` <style> :host { display: block; padding: 12px; border: 1px solid #ccc; } </style> <slot></slot> `; } } customElements.define('info-card', InfoCard);
之后就能在HTML中直接使用:<info-card>欢迎来到我的卡片</info-card>
如何让自定义元素支持属性和响应式更新?
要让元素像原生标签一样响应属性变化(如 <info-card title="标题"></info-card>),需配合以下机制:
- 在类中声明
static get observedAttributes(),返回字符串数组,列出要监听的属性名 - 实现
attributeChangedCallback(attrName, oldValue, newValue),在里面更新内部状态或DOM - 注意:只有通过
setAttribute或 HTML 属性写入才会触发该回调;直接改this.title = 'xxx'不会触发
基本上就这些。不复杂但容易忽略细节,比如命名规则、constructor 中必须调用 super()、以及 attachShadow 是可选但推荐的封装手段。