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

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.

Zdroje