CKTIS / HTML
shadowrootserializable — serijalizacija deklarativnog shadow roota
Booleov atribut shadowrootserializable označava deklarativni shadow root za serijalizaciju putem getHTML({ serializableShadowRoots: true }). Ne uključuje ga automatski u uobičajeni rezultat getHTML() ni u innerHTML elementa hosta.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<template shadowrootmode="open" shadowrootserializable>…</template>shadowrootserializable je booleov atribut elementa template. Kada parser iz shadowrootmode="open" ili shadowrootmode="closed" izradi deklarativni shadow root, prisutnost tog atributa postavlja njegovu oznaku za serijalizaciju. Sam shadowrootserializable, bez valjanog shadowrootmode, ne stvara shadow root. Da biste isključili tu mogućnost, izostavite atribut; i shadowrootserializable="false" računa se kao prisutan.
Poziv host.getHTML({ serializableShadowRoots: true }) uključuje označeni shadow root kao deklarativnu oznaku template s njegovim sadržajem. Uobičajeni host.getHTML() i čitanje host.innerHTML izostavljaju shadow root elementa hosta. Mogućnost shadowRoots metode getHTML() omogućuje izričit odabir rootova za serijalizaciju neovisno o njihovoj oznaci za serijalizaciju.
Serijalizacija nije kloniranje: shadowrootserializable ne zamjenjuje shadowrootclonable. Nije ni mehanizam za zaštitu podataka. Označeni root u načinu closed može se pojaviti i u serijalizaciji svojeg hosta, stoga u njega nemojte spremati tajne uz pretpostavku da taj način sprječava njihov izvoz.
Primjer učitajte kao HTML dokument kako bi parser stvorio deklarativni shadow root. Dodjela iste oznake u innerHTML neće ga stvoriti. Tri provjere prikazuju da se root prema zadanim postavkama izostavlja te da su njegov atribut i sadržaj prisutni kada je serijalizacija uključena.
Primjeri
<!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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.