CustomElementRegistry
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Januar 2020.
* Some parts of this feature may have varying levels of support.
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
| Specification |
|---|
| HTML # custom-elements-api |