Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

shadowrootclonable — klonowanie deklaratywnego korzenia cienia

Atrybut logiczny shadowrootclonable na elemencie template oznacza deklaratywny korzeń cienia jako klonowalny. Dzięki temu kopiowanie elementu gospodarza może objąć również jego drzewo cienia.

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

Składnia

<template shadowrootmode="open" shadowrootclonable>…</template>

shadowrootclonable jest atrybutem logicznym elementu template, używanym z shadowrootmode. Podczas tworzenia deklaratywnego korzenia cienia parser ustawia jego flagę klonowalności na podstawie obecności atrybutu. Bez niego flaga jest wyłączona; sam atrybut nie tworzy korzenia cienia.

Gdy korzeń jest klonowalny, host.cloneNode(true) kopiuje także jego drzewo cienia. Nie chodzi tu o zwykłe kopiowanie zawartości szablonu przez template.content.cloneNode(true), lecz o kopiowanie gospodarza z już utworzonym korzeniem.

Obecność oznacza włączenie: zapis shadowrootclonable="false" nadal je włącza i nie jest poprawnym sposobem wyłączenia atrybutu logicznego. Aby wyłączyć tę opcję w deklaracji, pomiń atrybut. shadowrootclonable nie zastępuje shadowrootserializable: klonowanie węzłów i serializacja HTML to osobne mechanizmy.

Przykład wymaga przeglądarki obsługującej deklaratywne korzenie cienia oraz ten atrybut. Otwórz cały dokument HTML, zamiast wstawiać znacznik przez innerHTML. Tryb open umożliwia sprawdzenie kopii przez copy.shadowRoot; skopiowanego gospodarza nie trzeba dołączać do dokumentu.

Przykłady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Shadow root cloning</title>
<div id="host"><template shadowrootmode="open" shadowrootclonable><span>Hello</span></template></div>
<pre id="result"></pre>
<script>
  const host = document.getElementById('host');
  const copy = host.cloneNode(true);
  document.getElementById('result').textContent =
    copy.shadowRoot?.textContent ?? 'No shadow root';
</script>
</html>

Wynik

Hello

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

Źródła