ShadowRoot: mode-Eigenschaft
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.
Die mode-Eigenschaft des ShadowRoot ist eine schreibgeschützte Eigenschaft, die den Modus angibt — entweder open oder closed. Dies definiert, ob die internen Features des Shadow Roots von JavaScript aus zugänglich sind oder nicht.
Wenn der mode eines Shadow Roots auf "closed" gesetzt ist, sind die Implementierungsdetails des Shadow Roots von JavaScript aus unzugänglich und unveränderlich — ebenso wie die Implementierungsdetails von beispielsweise dem <video>-Element von JavaScript aus unzugänglich und unveränderlich sind.
Der Eigenschaftswert wird mit der mode-Eigenschaft des Objekts gesetzt, das an Element.attachShadow() übergeben wird, oder mit dem shadowrootmode-Attribut des <template>-Elements, wenn ein Shadow Root deklarativ erstellt wird.
Wert
Ein String-Wert, der einen der folgenden Werte haben kann:
Beispiele
// We create a closed shadow root, that is not accessible
let element = document.createElement("div");
element.attachShadow({ mode: "closed" });
console.log(element.shadowRoot); // logs null as the shadow root is closed
// We create an open shadow root, that is accessible
let element2 = document.createElement("div");
element2.attachShadow({ mode: "open" });
console.log(`The shadow is ${element2.shadowRoot.mode}`); // logs "The shadow is open"
element2.shadowRoot.textContent = "Opened shadow"; // The shadow is open, we can access it from outside
Spezifikationen
| Specification |
|---|
| DOM # dom-shadowroot-mode |
Browser-Kompatibilität
Loading…