is属性仅对whatwg规范白名单中约20个原生标签(如button、canvas、table等)生效,必须配合customelements.define()中{extends:"xxx"}注册且注册名与is值严格一致,类须继承对应内置元素并首行调用super()。

is属性不是组件化开关,只对特定原生标签生效
浏览器不会因为你写了<div is="my-card">就自动把它变成可复用、可升级的组件。<code>is只在 WHATWG 规范白名单里的标签上起作用,比如<button></button>、<table>、<code><tr>、<code><canvas></canvas>等——总共约20个。写<p is="highlight"></p>或<section is="hero"></section>,解析后仍是普通HTMLParagraphElement,不触发任何自定义逻辑。
必须配合customElements.define() + extends才能激活
is本身只是个字符串属性,真正让它生效的唯一条件是:customElements.define("my-btn", MyBtn, { extends: "button" })。漏掉{ extends: "button" },哪怕注册了类、写了<button is="my-btn"></button>,实例也还是HTMLButtonElement,不是你的类。
- 注册名和
is值必须完全一致(大小写、连字符、空格全敏感) - 类必须继承对应内置元素(如
class MyBtn extends HTMLButtonElement),不能只继承HTMLElement -
constructor第一行必须调super(),否则this.disabled、this.value等原生属性不可用,focus()会报Illegal invocation
is不提供响应式、不管理状态、不自动更新UI
is只影响元素构造阶段——决定用哪个类来实例化这个 DOM 节点。它不监听属性变化,不触发重渲染,也不帮你同步data-*或value。比如你改了el.setAttribute("data-count", "5"),组件内部不会自动响应;想更新视图,还得自己写attributeChangedCallback并显式声明static get observedAttributes()。
-
observedAttributes里只能写属性名(如"count"),不能写"data-count" - 修改
dataset不会触发attributeChangedCallback,得用setAttribute("count", "5") - 没有虚拟 DOM,没有 diff,每次更新都得手动操作
this.shadowRoot或this.innerHTML
和jQuery、纯HTML模板混用时容易失效
在 jQuery 插件里加is="my-input"不会让插件自动识别为新组件,也不会触发customElements.upgrade()。jQuery 的$('button').myPlugin()运行时调用机制,与is依赖的 HTML 解析期构造机制根本不在一个层面。
-
customElements.upgrade(el)只对尚未升级的元素有效,且要求构造器已注册;在 jQuery 初始化函数里盲目调用,大概率静默失败 -
$('[is="my-card"]')能选中元素,但.myCard()插件不会因此自动激活 - 服务端返回的 HTML 里含
<button is="my-btn"></button>,但 JS 注册代码在DOMContentLoaded之后执行 → 元素已按原生方式构造完毕,无法补救
真正难的不是写customElements.define(),而是把is当作一种语义契约来维护:每个is值背后必须有明确的类定义、属性约定、生命周期行为和降级策略。一旦松动,它就退化成一个没意义的字符串属性。











