CKTIS / HTML
shadowrootserializable — serializace deklarativního shadow rootu
Logický atribut shadowrootserializable označuje deklarativní shadow root pro serializaci pomocí getHTML({ serializableShadowRoots: true }). Automaticky jej nezařazuje do běžného výstupu getHTML() ani do innerHTML hostitele.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<template shadowrootmode="open" shadowrootserializable>…</template>shadowrootserializable je logický atribut prvku template. Když parser vytvoří deklarativní shadow root z shadowrootmode="open" nebo shadowrootmode="closed", přítomnost tohoto atributu nastaví jeho příznak serializace. Samotný shadowrootserializable bez platného shadowrootmode shadow root nevytvoří. Chcete-li tuto možnost vypnout, atribut vynechte; také shadowrootserializable="false" se počítá jako přítomný.
Volání host.getHTML({ serializableShadowRoots: true }) zahrne označený shadow root jako deklarativní značku template s jeho obsahem. Běžné host.getHTML() a čtení host.innerHTML shadow root hostitele vynechají. Možnost shadowRoots metody getHTML() umožňuje výslovně vybrat kořeny k serializaci bez ohledu na jejich příznak serializace.
Serializace není klonování: shadowrootserializable nenahrazuje shadowrootclonable. Nejde ani o mechanismus ochrany dat. Označený root v režimu closed se může objevit také při serializaci svého hostitele, proto do něj neukládejte tajné údaje s předpokladem, že tento režim zabrání jejich exportu.
Příklad načtěte jako dokument HTML, aby parser vytvořil deklarativní shadow root. Přiřazení stejné značky do innerHTML jej nevytvoří. Tři kontroly ukazují výchozí vynechání rootu a přítomnost jeho atributu i obsahu při zapnuté serializaci.
Příklady
<!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>Výsledek
true true true
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.