CKTIS / HTML
shadowrootmode — deklaratives Shadow DOM
Mit dem Attribut shadowrootmode auf einem template-Element kann der HTML-Parser eine deklarative Shadow Root erstellen. Die Werte open und closed bestimmen den Zugriffsmodus dieser Root.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<template shadowrootmode="open|closed">…</template>shadowrootmode ist ein aufzählbares Attribut von template, kein boolesches Attribut. Es akzeptiert open oder closed. Ein fehlendes Attribut, ein leerer Wert und ein ungültiger Wert bedeuten alle den Zustand None: Das Attribut allein löst dann keine Erstellung einer Shadow Root aus.
Beim Parsen eines HTML-Dokuments erstellt eine gültige Deklaration eine Shadow Root auf dem übergeordneten Element, sofern dieses als Shadow-DOM-Host dienen kann. Der Inhalt der Deklaration gelangt in die Shadow Root, während das template selbst kein DOM-Kind des Hosts wird. Hat der Host bereits eine Shadow Root oder ist das Anfügen einer solchen nicht zulässig, lässt der Parser ein gewöhnliches template zurück.
Der Modus open ermöglicht den Zugriff auf die Root über host.shadowRoot; bei closed gibt diese Eigenschaft null zurück. Beide Modi erstellen Shadow DOM — closed bedeutet nicht, dass der Inhalt nicht gerendert wird.
Dies ist ein Parsermechanismus und kein nachträglich wirkender Schalter: Wird shadowrootmode zu einem vorhandenen template hinzugefügt, entsteht dadurch keine Shadow Root. Auch das Zuweisen des Markups zu innerHTML aktiviert kein deklaratives Shadow DOM. Öffne das Beispiel als HTML-Dokument, statt es über innerHTML einzufügen.
Beispiele
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Declarative shadow DOM</title>
<div id="host"><template shadowrootmode="open"><span>Hello</span></template></div>
<pre id="result"></pre>
<script>
const host = document.getElementById('host');
document.getElementById('result').textContent = [
host.shadowRoot.mode,
host.shadowRoot.querySelector('span').textContent,
String(host.querySelector('template'))
].join('\n');
</script>
</html>Ergebnis
open Hello null
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.