自定义元素命名必须含短横线，如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('标签名', 类名)完成注册
示例：一个带文字内容的简单卡片
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
立即学习“Java免费学习笔记（深入）”；
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 是可选但推荐的封装手段。
