什么是web组件_javascript中如何创建自定义元素?

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

Web组件是一套浏览器原生支持的前端技术标准,核心包括自定义元素(Custom Elements)、影子DOM(Shadow DOM)和HTML模板()。它让开发者能封装可复用、样式与逻辑隔离的HTML标签,比如 ,无需框架也能实现“组件化”。

自定义元素必须满足哪些命名规则?

浏览器强制要求自定义元素名中必须包含短横线(-),例如 user-cardloading-spinner。这是为了确保不与现有或未来HTML标准标签冲突。像 mydivButton 这样的名字会直接报错,无法注册。

用 JavaScript 创建自定义元素的三步法

现代方式基于 ES6 类 + customElements.define(),步骤清晰:

  • 定义一个继承自 HTMLElement 的类,可添加生命周期钩子(如 connectedCallbackdisconnectedCallback
  • 在类中封装属性响应(通过 static get observedAttributes()attributeChangedCallback
  • 调用 customElements.define('标签名', 类名) 完成注册

示例:一个带文字内容的简单卡片

class InfoCard extends HTMLElement {
  constructor() {
    super();
    this.attachShadow({ mode: 'open' });
    this.shadowRoot.innerHTML = `
      
      
    `;
  }
}

customElements.define('info-card', InfoCard);

之后就能在HTML中直接使用:欢迎来到我的卡片

如何让自定义元素支持属性和响应式更新?

要让元素像原生标签一样响应属性变化(如 ),需配合以下机制:

  • 在类中声明 static get observedAttributes(),返回字符串数组,列出要监听的属性名
  • 实现 attributeChangedCallback(attrName, oldValue, newValue),在里面更新内部状态或DOM
  • 注意:只有通过 setAttribute 或 HTML 属性写入才会触发该回调;直接改 this.title = 'xxx' 不会触发

基本上就这些。不复杂但容易忽略细节,比如命名规则、constructor 中必须调用 super()、以及 attachShadow 是可选但推荐的封装手段。