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

瀏覽器相容性