Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / HTML

shadowrootserializable — serializácia deklaratívneho shadow rootu

Logický atribút shadowrootserializable označuje deklaratívny shadow root na serializáciu pomocou getHTML({ serializableShadowRoots: true }). Automaticky ho nezahŕňa do bežného výstupu getHTML() ani do innerHTML hostiteľa.

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

Syntax

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

shadowrootserializable je logický atribút prvku template. Keď parser vytvorí deklaratívny shadow root z shadowrootmode="open" alebo shadowrootmode="closed", prítomnosť tohto atribútu nastaví jeho príznak serializácie. Samotný shadowrootserializable bez platného shadowrootmode shadow root nevytvorí. Ak chcete túto možnosť vypnúť, atribút vynechajte; aj shadowrootserializable="false" sa počíta ako prítomný.

Volanie host.getHTML({ serializableShadowRoots: true }) zahrnie označený shadow root ako deklaratívnu značku template s jeho obsahom. Bežné host.getHTML() a čítanie host.innerHTML shadow root hostiteľa vynechajú. Možnosť shadowRoots metódy getHTML() umožňuje výslovne vybrať korene na serializáciu bez ohľadu na ich príznak serializácie.

Serializácia nie je klonovanie: shadowrootserializable nenahrádza shadowrootclonable. Nie je to ani mechanizmus ochrany údajov. Označený root v režime closed sa môže objaviť aj pri serializácii svojho hostiteľa, preto doň neukladajte tajné údaje s predpokladom, že tento režim zabráni ich exportu.

Príklad načítajte ako dokument HTML, aby parser vytvoril deklaratívny shadow root. Priradenie rovnakej značky do innerHTML ho nevytvorí. Tri kontroly ukazujú predvolené vynechanie rootu a prítomnosť jeho atribútu aj obsahu pri zapnutej serializácii.

Prí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ýsledok

true
true
true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje