直接用 innerHTML 插入 <template> 会丢事件且引发 ID 冲突，因其 content 是离线 DocumentFragment，移动节点导致后续为空，同名 id 多次克隆破坏 DOM 唯一性；必须用 cloneNode(true) 克隆并动态生成唯一标识。
为什么直接用 innerHTML 插入 <template> 会丢事件和 ID 冲突
因为 <template> 的 content 是一个离线的 DocumentFragment，它不挂载在 DOM 树中，也没有生命周期。直接 innerHTML 赋值或 appendChild(template.content) 本质是“移动节点”，不是复制——第一次用完，后续再调用就只剩空 fragment；更严重的是，如果模板里有 id="submit-btn"，多次克隆后页面出现多个同名 id，document.getElementById('submit-btn') 只返回第一个，CSS 选择器和 ARIA 关联全乱套。
必须始终用：template.content.cloneNode(true)。这是唯一安全的起点。
- 别写
document.body.appendChild(template.content)—— 这是移动，不是复用 - 别在模板里硬写
id或name属性，改用data-id或运行时动态生成唯一值（如crypto.randomUUID()） - 克隆后立即重设关键属性：
instance.querySelector('[data-role="title"]').textContent = data.title
customElements.define() 该上还是不该上：看三个硬指标
不是“想封装就上 Web Components”，而是当这三个条件同时满足时，customElements.define() 才是正解：
- 需要样式完全隔离（比如组件内
.btn绝对不能影响全局.btn） - 组件会被嵌入第三方页面或 CMS 系统，且你无法控制其全局 CSS/JS 环境
- 目标浏览器支持
Shadow DOM v1（Chrome 67+、Firefox 63+、Safari 16.4+；Edge 已随 Chromium 统一）
否则，纯 <template> + 工厂函数更轻量、调试更直观。很多团队过早引入 Custom Elements，结果卡在 connectedCallback 时机、attributeChangedCallback 同步开销、或 Safari 对 slot 的旧版兼容问题上。
立即学习“前端免费学习笔记（深入）”；
注意：customElements.define('user-card', UserCard) 中的标签名必须含短横线，<usercard> 会静默失败。
如何让同一个组件适配静态页、CMS 输出、SSR 预渲染三类场景
核心矛盾在于：静态页要零构建、CMS 输出要可解析 HTML 字符串、SSR 要服务端生成结构。硬塞 JS 渲染或强依赖模块系统会断掉其中一类。
可行路径是分层设计：
- 底层：语义化结构不动 —— 卡片用
<article class="card">，导航用<nav role="navigation">，保证即使 JS 失败或未加载，内容仍可读、可索引、可被爬虫识别 - 中层：模板统一用
data-bind声明绑定点，如<h3 data-bind="title"></h3>，而非靠 class 名（class="card-title"容易冲突） - 上层：按场景提供不同消费方式 —— 静态页调工厂函数，CMS 导出预填充的 HTML 字符串，SSR 则走 Node.js 模板引擎（如 Nunjucks）直出带数据的结构
例如 CMS 导出时，只需执行一次 createCard({ title: '最新动态', content: '...' }).outerHTML，把完整 DOM 片段当字符串吐出去，不依赖客户端 JS。
容易被忽略的“复用性”陷阱：内容字段比结构更关键
很多人花大力气抽离了卡片 HTML 结构，但每个实例仍手动写 <p>这里是描述</p> —— 这根本没实现复用。真正可复用的组件，字段必须稳定且可映射。
检查你的组件是否具备明确的内容契约：
- 卡片组件：至少应支持
title、description、imageSrc、ctaText四个字段 - FAQ 组件：必须定义
question和answer，且answer支持 HTML 字符串（需 sanitize） - 表单组件：字段名（
name）、占位符（placeholder）、校验规则（required、type="email"）都得作为输入参数
一旦字段不收敛，每次新增页面就得改组件逻辑，所谓“复用”只是把重复劳动从 HTML 搬到了 JS 里。
