CKTIS / HTML
shadowrootserializable — serializacja deklaratywnego shadow root
Atrybut logiczny shadowrootserializable oznacza deklaratywny shadow root jako przeznaczony do serializacji przez getHTML({ serializableShadowRoots: true }). Nie powoduje automatycznego dołączania go do zwykłego wyniku getHTML() ani do innerHTML hosta.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<template shadowrootmode="open" shadowrootserializable>…</template>shadowrootserializable jest atrybutem logicznym elementu template. Gdy parser tworzy deklaratywny shadow root na podstawie shadowrootmode="open" lub shadowrootmode="closed", obecność tego atrybutu ustawia jego znacznik serializacji. Sam shadowrootserializable, bez prawidłowego shadowrootmode, nie tworzy shadow root. Aby wyłączyć tę opcję, pomiń atrybut; zapis shadowrootserializable="false" nadal oznacza jego obecność.
Wywołanie host.getHTML({ serializableShadowRoots: true }) uwzględnia oznaczony shadow root jako deklaratywny znacznik template wraz z jego zawartością. Zwykłe host.getHTML() oraz odczyt host.innerHTML pomijają shadow root hosta. Opcja shadowRoots w getHTML() pozwala jawnie wskazać korzenie do serializacji niezależnie od ich znacznika serializacji.
Serializacja nie jest klonowaniem: shadowrootserializable nie zastępuje shadowrootclonable. Nie jest też mechanizmem ochrony danych. Oznaczony korzeń w trybie closed również może znaleźć się w wyniku serializacji hosta, więc nie umieszczaj w nim sekretów z założeniem, że ten tryb ochroni je przed eksportem.
Przykład należy wczytać jako dokument HTML, aby parser utworzył deklaratywny shadow root. Przypisanie tego samego znacznika do innerHTML go nie utworzy. Trzy sprawdzenia pokazują domyślne pominięcie korzenia oraz obecność atrybutu i zawartości po włączeniu serializacji.
Przykłady
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>shadowrootserializable</title>
<div id="host"><template shadowrootmode="open" shadowrootserializable><span>Hello</span></template></div>
<pre id="result"></pre>
<script>
const host = document.getElementById('host');
const html = host.getHTML({ serializableShadowRoots: true });
document.getElementById('result').textContent = [
host.getHTML() === '',
html.includes('shadowrootserializable=""'),
html.includes('<span>Hello</span>')
].join('\n');
</script>
</html>Wynik
true true true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.