<p>原生 Custom Element 无数据驱动能力，需手动实现响应逻辑；observedAttributes 仅监听 HTML attribute 而非 JS property，且须严格匹配命名、处理 null oldValue、防重复更新；JS 属性变化需 Proxy 或 Object.defineProperty 拦截；data-* 仅用于初始化，非响应式；render() 应幂等、局部更新、避免副作用。</p>
原生 Custom Element 不自带数据驱动能力，必须手动补足响应逻辑才能让“数据变 → 视图动”真正成立；否则你写的只是带标签的静态模板。
observedAttributes 只监听 HTML attribute，不监听 JS property
如果你改的是 this.count = 5，哪怕 observedAttributes 里写了 'count'，attributeChangedCallback 也完全不会触发——它只响应 el.setAttribute('count', '5') 或 HTML 初始属性解析。
- 必须显式声明
static get observedAttributes()，且数组中字符串要和 HTML 属性名**逐字符一致**（大小写、连字符都不能错） - 首次挂载时已存在的属性会触发一次回调，但
oldValue是null，得用=== null判断，别用!oldValue - 回调里别直接对
newValue做运算，比如Number(newValue) + 1，遇到null就得 NaN - 记得加
if (oldValue === newValue)防重复更新，尤其在框架批量 setAttribute 场景下很常见
JS 属性变化得自己用 Proxy 或 Object.defineProperty 拦截
attributeChangedCallback 管不了 this.title 这种 JS 属性，想让它变就重渲染，就得自己加 setter。
- 推荐在
constructor或connectedCallback中用Object.defineProperty封装关键属性，例如title、loading - setter 里调用
this.render()，而不是直接操作this.innerHTML——后者会清空事件监听器、丢失子组件状态 -
render()应只操作this.shadowRoot，确保样式和事件作用域隔离 - Proxy 更灵活但兼容性略差，若需支持 Safari 14 以下，优先选
Object.defineProperty
data-* 属性不是响应式源头，只是初始化传参通道
data-user-id 这类属性值全是字符串，且浏览器不会因它变化而通知你——它只适合在元素创建时读一次，做初始配置。
立即学习“前端免费学习笔记（深入）”；
- 在
connectedCallback里用this.dataset.userId读取，注意连字符自动转驼峰：data-api-url→this.dataset.apiUrl - 布尔值如
data-disabled="true"必须显式写字符串，不能只写data-disabled，否则this.dataset.disabled是空字符串 - 数值要用
Number(this.dataset.step)转，别信+this.dataset.step，遇到空字符串会变成NaN - 千万别把
data-当状态管理用：多个组件要同步？存 localStorage？走网络？全得靠 JS 变量 + 事件派发，不是往 DOM 上堆 data- 属性
render() 方法必须可控、幂等、无副作用
每次数据变化都调 render()，但它不能每次都暴力重写整个 shadowRoot —— 性能差，还容易丢状态。
- 避免在
render()里反复创建新元素或绑定新事件，优先复用已有节点、用textContent或className更新局部 - 如果用了 innerHTML，确保所有子元素都带唯一
key属性，否则 Shadow DOM 下事件监听器可能失效 - 不要在
render()里发起 fetch 或调用外部 API，这会让更新不可预测；异步逻辑应放在数据 setter 或事件处理中 - 复杂 UI 推荐拆成子自定义元素，各自管自己的
render()，主组件只负责数据分发和生命周期协调
最常被忽略的一点：attributeChangedCallback 和 JS property setter 的触发时机不同、来源不同、类型不同，混用却不做类型校验和变更过滤，是导致视图抖动、重复渲染、NaN 值崩溃的根源。别指望浏览器替你做判断，每个 if 和 Number() 都得亲手写清楚。
