Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

shadowrootmode — deklaratywny Shadow DOM

Atrybut shadowrootmode elementu template pozwala parserowi HTML utworzyć deklaratywny korzeń cienia. Wartości open i closed określają tryb dostępu do tego korzenia.

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

Składnia

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

shadowrootmode jest atrybutem wyliczeniowym elementu template, a nie atrybutem logicznym. Przyjmuje open lub closed. Brak atrybutu, pusta wartość i nieprawidłowa wartość oznaczają stan None: sam ten atrybut nie uruchamia wtedy tworzenia korzenia cienia.

Podczas parsowania dokumentu HTML poprawna deklaracja tworzy korzeń cienia na elemencie nadrzędnym, jeśli może on być gospodarzem Shadow DOM. Zawartość deklaracji trafia do korzenia cienia, a sam template nie zostaje dzieckiem gospodarza w DOM. Jeżeli gospodarz ma już korzeń cienia albo dołączenie nowego jest niedozwolone, parser pozostawia zwykły template.

Tryb open pozwala pobrać korzeń przez host.shadowRoot; dla closed ta właściwość zwraca null. Oba tryby tworzą Shadow DOM — closed nie oznacza, że zawartość nie będzie renderowana.

To mechanizm parsera, a nie przełącznik działający wstecz: dodanie shadowrootmode do istniejącego template nie tworzy korzenia cienia. Przypisanie znacznika do innerHTML również nie uruchamia deklaratywnego Shadow DOM. Przykład należy otworzyć jako dokument HTML, a nie wklejać przez innerHTML.

Przykłady

<!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>

Wynik

open
Hello
null

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła