CKTIS / HTML
shadowrootserializable — serializacija deklarativnega shadow root
Logični atribut shadowrootserializable označi deklarativni shadow root za serializacijo prek getHTML({ serializableShadowRoots: true }). Samodejno ga ne vključi v običajni rezultat getHTML() ali v innerHTML gostitelja.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<template shadowrootmode="open" shadowrootserializable>…</template>shadowrootserializable je logični atribut elementa template. Ko razčlenjevalnik ustvari deklarativni shadow root iz shadowrootmode="open" ali shadowrootmode="closed", prisotnost tega atributa nastavi njegovo zastavico za serializacijo. Sam shadowrootserializable brez veljavnega shadowrootmode ne ustvari shadow root. Če želite možnost izklopiti, atribut izpustite; tudi shadowrootserializable="false" šteje kot prisoten.
Klic host.getHTML({ serializableShadowRoots: true }) vključi označeni shadow root kot deklarativno oznako template z njegovo vsebino. Običajni host.getHTML() in branje host.innerHTML izpustita shadow root gostitelja. Možnost shadowRoots metode getHTML() omogoča izrecno izbiro rootov za serializacijo ne glede na njihovo zastavico za serializacijo.
Serializacija ni kloniranje: shadowrootserializable ne nadomešča shadowrootclonable. Prav tako ni mehanizem za zaščito podatkov. Označeni root v načinu closed se lahko pojavi tudi pri serializaciji gostitelja, zato vanj ne shranjujte skrivnosti ob predpostavki, da ta način preprečuje njihov izvoz.
Primer naložite kot dokument HTML, da razčlenjevalnik ustvari deklarativni shadow root. Če isto oznako dodelite innerHTML, ga ne bo ustvarila. Tri preverjanja pokažejo, da je root privzeto izpuščen, ob vklopljeni serializaciji pa sta vključena njegov atribut in vsebina.
Primeri
<!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>Rezultat
true true true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.