Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

shadowrootmode — deklarativní Shadow DOM

Atribut shadowrootmode prvku template umožňuje analyzátoru HTML vytvořit deklarativní kořen stínového DOM. Hodnoty open a closed určují režim přístupu k tomuto kořenu.

Verze: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<template shadowrootmode="open|closed">…</template>

shadowrootmode je výčtový atribut prvku template, nikoli booleovský atribut. Přijímá hodnoty open nebo closed. Chybějící atribut, prázdná hodnota i neplatná hodnota znamenají stav None: samotný atribut pak vytvoření kořene stínového DOM nespustí.

Při parsování dokumentu HTML vytvoří platná deklarace kořen stínového DOM na rodičovském prvku, pokud může sloužit jako hostitel Shadow DOM. Obsah deklarace se vloží do kořene stínového DOM, zatímco samotný template se nestane DOM potomkem hostitele. Pokud už hostitel kořen stínového DOM má nebo není povoleno připojit další, parser ponechá běžný template.

Režim open umožňuje získat kořen přes host.shadowRoot; v režimu closed tato vlastnost vrací null. Oba režimy vytvářejí Shadow DOM — closed neznamená, že se obsah nebude vykreslovat.

Jde o mechanismus parseru, nikoli o přepínač působící zpětně: přidání shadowrootmode k existujícímu template kořen stínového DOM nevytvoří. Ani přiřazení značek do innerHTML deklarativní Shadow DOM neaktivuje. Příklad otevřete jako dokument HTML, místo abyste jej vložili pomocí innerHTML.

Pří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ýsledek

open
Hello
null

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje