Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori