Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori