CustomElementRegistry
Baseline
Weitgehend verfügbar
*
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2020 browserübergreifend verfügbar.
* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.
Das CustomElementRegistry-Interface bietet Methoden zum Registrieren benutzerdefinierter Elemente und zum Abfragen registrierter Elemente. Um eine Instanz davon zu erhalten, verwenden Sie die window.customElements-Eigenschaft. Um ein gescoptes Register zu erstellen, verwenden Sie den CustomElementRegistry()-Konstruktor.
Konstruktor
CustomElementRegistry()-
Erstellt ein neues
CustomElementRegistry-Objekt zur gescopten Nutzung.
Instanzmethoden
CustomElementRegistry.define()-
Definiert ein neues benutzerdefiniertes Element.
CustomElementRegistry.get()-
Gibt den Konstruktor für das benannte benutzerdefinierte Element zurück, oder
undefined, wenn das benutzerdefinierte Element nicht definiert ist. CustomElementRegistry.getName()-
Gibt den Namen für das bereits definierte benutzerdefinierte Element zurück, oder
null, wenn das benutzerdefinierte Element nicht definiert ist. CustomElementRegistry.upgrade()-
Aktualisiert ein benutzerdefiniertes Element direkt, auch bevor es mit seiner Schattenwurzel verbunden wird.
CustomElementRegistry.initialize()-
Verknüpft ein gescoptes Register mit einem DOM-Teilbaum, legt das benutzerdefinierte Elemente-Register an jedem inklusiven Nachfahren fest und aktualisiert gegebenenfalls benutzerdefinierte Elemente.
CustomElementRegistry.whenDefined()-
Gibt ein leeres
Promisezurück, das sich auflöst, wenn ein benutzerdefiniertes Element mit dem gegebenen Namen definiert wird. Wenn ein solches benutzerdefiniertes Element bereits definiert ist, wird das zurückgegebene Versprechen sofort erfüllt.
Beispiele
Siehe den Abschnitt Beispiele in unserem Leitfaden zur Verwendung benutzerdefinierter Elemente.
Spezifikationen
| Spezifikation |
|---|
| HTML # custom-elements-api |