Diemode-Eigenschaft desShadowRoot ist eine schreibgeschützte Eigenschaft, die den Modus angibt — entwederopen oderclosed. Dies definiert, ob die internen Features des Shadow Roots von JavaScript aus zugänglich sind oder nicht.

Wenn dermode 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 dermode-Eigenschaft des Objekts gesetzt, das anElement.attachShadow() übergeben wird, oder mit demshadowrootmode-Attribut des<template>-Elements, wenn ein Shadow Root deklarativ erstellt wird.

Wert

Ein String-Wert, der einen der folgenden Werte haben kann:

open

Elemente des Shadow Roots sind von JavaScript außerhalb des Roots aus zugänglich.

closed

Knoten im geschlossenen Shadow-Baum können von JavaScript außerhalb des Roots nicht zugegriffen werden.

Beispiele

// We create a closed shadow root, that is not accessiblelet 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 accessiblelet 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

Browser-Kompatibilität