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

Spezifikationen

Specification
HTML Standard
# custom-elements-api

Browser-Kompatibilität

BCD tables only load in the browser