CKTIS / HTML
shadowrootmode — deklarativni Shadow DOM
Atribut shadowrootmode elementa template omogućuje HTML parseru stvaranje deklarativnog korijena sjenovitog DOM-a. Vrijednosti open i closed određuju način pristupa tom korijenu.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<template shadowrootmode="open|closed">…</template>shadowrootmode je enumerirani atribut elementa template, a ne booleov atribut. Prihvaća vrijednosti open ili closed. Nedostajući atribut, prazna vrijednost i nevaljana vrijednost označavaju stanje None: sam atribut tada ne pokreće stvaranje korijena sjenovitog DOM-a.
Tijekom parsiranja HTML dokumenta valjana deklaracija stvara korijen sjenovitog DOM-a na nadređenom elementu ako on može biti domaćin za Shadow DOM. Sadržaj deklaracije ulazi u korijen sjenovitog DOM-a, dok sam template ne postaje DOM dijete domaćina. Ako domaćin već ima korijen sjenovitog DOM-a ili dodavanje novoga nije dopušteno, parser ostavlja običan template.
Način open omogućuje dohvaćanje korijena putem host.shadowRoot; za closed to svojstvo vraća null. Oba načina stvaraju Shadow DOM — closed ne znači da sadržaj neće biti prikazan.
Ovo je mehanizam parsera, a ne prekidač koji djeluje unatrag: dodavanje shadowrootmode postojećem elementu template ne stvara korijen sjenovitog DOM-a. Ni dodjela oznaka u innerHTML ne aktivira deklarativni Shadow DOM. Primjer otvorite kao HTML dokument, umjesto da ga umetnete putem innerHTML.
Primjeri
<!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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.