CustomElementRegistry

Baseline 广泛可用 *

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2020 年 1 月⁩ 起,所有主流浏览器均已支持。

* 此特性的某些部分可能存在不同级别的支持。

CustomElementRegistry 接口提供了用于注册自定义元素和查询已注册元素的方法。要获取其实例,请使用 window.customElements 属性。

实例方法

CustomElementRegistry.define()

定义一个新的自定义元素

CustomElementRegistry.get()

返回指定名称的自定义元素的构造函数,如果自定义元素未定义,则返回 undefined

CustomElementRegistry.getName()

返回已定义的自定义元素的名称,如果自定义元素未定义,则返回 null

CustomElementRegistry.upgrade()

直接升级自定义元素,甚至在其连接到其影子根之前。

CustomElementRegistry.whenDefined()

返回一个空的 Promise,当具有给定名称的自定义元素被定义时,该 Promise 将解析。如果此类自定义元素已定义,则返回的 Promise 将立即完成。

示例

请参阅我们的自定义元素使用指南中的示例部分。

规范

规范
HTML
# custom-elements-api

浏览器兼容性