Element: customElementRegistry-Eigenschaft
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
Die schreibgeschützte Eigenschaft customElementRegistry des Element-Interfaces gibt das diesem Element zugeordnete CustomElementRegistry-Objekt zurück oder null, wenn keines festgelegt wurde.
Die customElementRegistry eines Elements wird festgelegt, wenn das Element erstellt wird (beispielsweise über Document.createElement() mit der Option customElementRegistry oder wenn es in einem Kontext mit einer bereichsbezogenen Registry geparst wird). Sobald sie auf ein CustomElementRegistry-Objekt festgelegt wurde, kann sie nicht mehr geändert werden. Die Registry bestimmt, welche Definitionen von benutzerdefinierten Elementen verwendet werden, wenn das Element aktualisiert wird.
Wert
Ein CustomElementRegistry-Objekt oder null.
Beispiele
Zugriff auf die Custom-Element-Registry eines Elements
Dieses Beispiel erstellt eine bereichsbezogene Registry, fügt sie an eine Shadow-Root an und liest dann die Eigenschaft customElementRegistry von einem Element innerhalb des Shadow Tree aus, um zu bestätigen, dass sie mit der bereichsbezogenen Registry übereinstimmt.
const myRegistry = new CustomElementRegistry();
myRegistry.define(
"my-element",
class extends HTMLElement {
connectedCallback() {
this.textContent = "Hello from scoped registry!";
}
},
);
const host = document.createElement("div");
document.body.appendChild(host);
const shadow = host.attachShadow({
mode: "open",
customElementRegistry: myRegistry,
});
shadow.innerHTML = "<my-element></my-element>";
const el = shadow.querySelector("my-element");
console.log(el.customElementRegistry === myRegistry); // true
Spezifikationen
| Spezifikation |
|---|
| DOM # dom-element-customelementregistry |