CKTIS / HTML
shadowrootmode — deklarativni Shadow DOM
Atribut shadowrootmode elementa template omogoča razčlenjevalniku HTML, da ustvari deklarativni koren senčnega DOM. Vrednosti open in closed določata način dostopa do tega korena.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<template shadowrootmode="open|closed">…</template>shadowrootmode je enumerirani atribut elementa template, ne logični atribut. Sprejema vrednosti open ali closed. Če atribut manjka, je prazen ali ima neveljavno vrednost, to pomeni stanje None: sam atribut v tem primeru ne sproži ustvarjanja korena senčnega DOM.
Med razčlenjevanjem dokumenta HTML veljavna deklaracija ustvari koren senčnega DOM na nadrejenem elementu, če lahko ta gosti Shadow DOM. Vsebina deklaracije se vstavi v koren senčnega DOM, sam template pa ne postane DOM-otrok gostitelja. Če gostitelj že ima koren senčnega DOM ali dodajanje novega ni dovoljeno, razčlenjevalnik pusti navaden template.
Način open omogoča pridobitev korena prek host.shadowRoot; pri načinu closed ta lastnost vrne null. Oba načina ustvarita Shadow DOM — closed ne pomeni, da vsebina ne bo prikazana.
To je mehanizem razčlenjevalnika, ne stikalo, ki bi delovalo za nazaj: dodajanje shadowrootmode obstoječemu elementu template ne ustvari korena senčnega DOM. Tudi dodelitev oznak v innerHTML ne aktivira deklarativnega Shadow DOM. Primer odprite kot dokument HTML, namesto da ga vstavite prek innerHTML.
Primeri
<!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>Rezultat
open Hello null
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.