CKTIS / HTML
shadowrootserializable — serializzare una radice shadow dichiarativa
L’attributo booleano shadowrootserializable contrassegna una radice shadow dichiarativa per la serializzazione tramite getHTML({ serializableShadowRoots: true }). Non la include automaticamente nel risultato ordinario di getHTML() né nell’innerHTML dell’host.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<template shadowrootmode="open" shadowrootserializable>…</template>shadowrootserializable è un attributo booleano dell’elemento template. Quando il parser crea una radice shadow dichiarativa da shadowrootmode="open" o shadowrootmode="closed", la presenza di questo attributo imposta il relativo flag di serializzazione. shadowrootserializable da solo, senza un shadowrootmode valido, non crea una radice shadow. Per disattivare l’opzione, ometti l’attributo; anche shadowrootserializable="false" viene considerato presente.
La chiamata host.getHTML({ serializableShadowRoots: true }) include la radice shadow contrassegnata come markup dichiarativo template, insieme al suo contenuto. La chiamata ordinaria host.getHTML() e la lettura di host.innerHTML omettono la radice shadow dell’host. L’opzione shadowRoots di getHTML() consente di selezionare esplicitamente le radici da serializzare, indipendentemente dal relativo flag di serializzazione.
La serializzazione non è clonazione: shadowrootserializable non sostituisce shadowrootclonable. Inoltre non è un meccanismo di protezione dei dati. Una radice contrassegnata in modalità closed può comparire nella serializzazione del proprio host; non inserirvi quindi segreti pensando che tale modalità ne impedisca l’esportazione.
Carica l’esempio come documento HTML affinché il parser crei la radice shadow dichiarativa. Assegnare lo stesso markup a innerHTML non la creerà. I tre controlli mostrano l’omissione predefinita della radice e la presenza del suo attributo e contenuto quando la serializzazione è attiva.
Esempi
<!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>Risultato
true true true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.