CKTIS / HTML
shadowrootmode — deklaratívny Shadow DOM
Atribút shadowrootmode prvku template umožňuje HTML parseru vytvoriť deklaratívny koreň tieňového DOM. Hodnoty open a closed určujú režim prístupu k tomuto koreňu.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<template shadowrootmode="open|closed">…</template>shadowrootmode je výčtový atribút prvku template, nie booleovský atribút. Prijíma hodnoty open alebo closed. Chýbajúci atribút, prázdna hodnota aj neplatná hodnota znamenajú stav None: samotný atribút potom nespustí vytvorenie koreňa tieňového DOM.
Počas parsovania dokumentu HTML vytvorí platná deklarácia koreň tieňového DOM na rodičovskom prvku, ak môže slúžiť ako hostiteľ Shadow DOM. Obsah deklarácie sa vloží do koreňa tieňového DOM, zatiaľ čo samotný template sa nestane DOM potomkom hostiteľa. Ak už hostiteľ koreň tieňového DOM má alebo nie je povolené pripojiť ďalší, parser ponechá bežný template.
Režim open umožňuje získať koreň cez host.shadowRoot; pri režime closed táto vlastnosť vráti null. Oba režimy vytvárajú Shadow DOM — closed neznamená, že sa obsah nebude vykresľovať.
Ide o mechanizmus parsera, nie o prepínač pôsobiaci spätne: pridanie shadowrootmode k existujúcemu template nevytvorí koreň tieňového DOM. Ani priradenie značiek do innerHTML neaktivuje deklaratívny Shadow DOM. Príklad otvorte ako dokument HTML, namiesto toho, aby ste ho vložili cez innerHTML.
Príklady
<!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>Výsledok
open Hello null
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.