Autonomous custom elements
CustomElementRegistry インターフェイスは、カスタム要素の登録と、登録された要素を照会するためのメソッドを提供します。このインスタンスを取得するには、window.customElements プロパティを使用してください。スコープ付きのレジストリーを作成する場合は、CustomElementRegistry() コンストラクターを使用してください。
対応ブラウザ
| 機能 | デスクトップ | モバイル | ||||
|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Safari | Chrome Android | Safari iOS | |
| 54 | 79 | 63 | 10 | 54 | 10 | |
| DOM API | ||||||
| CustomElementRegistry インターフェイスは、カスタム要素の登録と、登録された要素を照会するためのメソッドを提供します。このインスタンスを取得するには、window.customElements プロパティを使用してください。 | 54 | 79 | 63 | 10.1 | 54 | 10.3 |
| define() は CustomElementRegistry インターフェイスのメソッドで、新しいカスタム要素を定義します。 | 54 | 79 | 63 | 10.1 | 54 | 10.3 |
define (disabledFeatures static property) 「disabledFeature」静的プロパティをサポートします | 77 | 79 | 92 | | 77 | |
| get() は CustomElementRegistry インターフェイスのメソッドで、以前定義したカスタム要素のコンストラクターを返します。 | 54 | 79 | 63 | 10.1 | 54 | 10.3 |
| CustomElementRegistry インターフェイスの getName() メソッドは、以前に定義されたカスタム要素の名前を返します。 | 117 | 117 | 116 | 17 | 117 | 17 |
| upgrade() は CustomElementRegistry インターフェイスのメソッドで、 Node サブツリー内のすべてのシャドウを含むカスタム要素を、メイン文書に接続する前であってもアップグレードします。 | 68 | 79 | 63 | 12.1 | 68 | 12.2 |
| whenDefined() は CustomElementRegistry インターフェイスのメソッドで、指定した名前の要素が定義されたときに解決されるプロミス (Promise) を返します。 | 54 | 79 | 63 | 10.1 | 54 | 10.3 |
| customElements は Window インターフェイスの読み取り専用プロパティで、 CustomElementRegistry オブジェクトへのリファレンスを返します。これにより、新しいカスタム要素を登録したり、以前に登録したカスタム要素に関する情報を取得したりすることができます。 | 54 | 79 | 63 | 10.1 | 54 | 10.3 |
- このブラウザでは部分的にしか実装されていません
- 「自律カスタム要素」はサポートされますが、「カスタマイズされた組み込み要素」はサポートされません。 バグ 182671 を参照してください。
- このブラウザでは部分的にしか実装されていません
- 「自律カスタム要素」はサポートされますが、「カスタマイズされた組み込み要素」はサポートされません。 バグ 182671 を参照してください。
- このブラウザでは部分的にしか実装されていません
- 「自律カスタム要素」はサポートされますが、「カスタマイズされた組み込み要素」はサポートされません。
- このブラウザでは部分的にしか実装されていません
- 「自律カスタム要素」はサポートされますが、「カスタマイズされた組み込み要素」はサポートされません。
実務での使いどころ
-
Autonomous custom elements の活用
CustomElementRegistry インターフェイスは、カスタム要素の登録と、登録された要素を照会するためのメソッドを提供します。
注意点
- 古いブラウザでは対応していない場合がある。
実装メモ
- 一部の API はセキュアコンテキスト (HTTPS) やユーザー操作起点を必要とする。利用前に要件を確認すること。