CustomElementRegistry
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.
Das CustomElementRegistry
Interface bietet Methoden zum Registrieren von benutzerdefinierten Elementen und zum Abfragen von registrierten Elementen. Um eine Instanz davon zu erhalten, verwenden Sie die Eigenschaft window.customElements
.
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 seinem Shadow-Root verbunden ist.
CustomElementRegistry.whenDefined()
-
Gibt ein leeres
Promise
zurück, das aufgelöst wird, wenn ein benutzerdefiniertes Element mit dem gegebenen Namen definiert wird. Wenn ein solches benutzerdefiniertes Element bereits definiert ist, wird das zurückgegebene Promise sofort erfüllt.
Beispiele
Siehe den Abschnitt Beispiele in unserem Leitfaden zur Verwendung benutzerdefinierter Elemente.
Spezifikationen
Specification |
---|
HTML Standard # custom-elements-api |
Browser-Kompatibilität
BCD tables only load in the browser