CKTIS / HTML
shadowrootserializable — een declaratieve shadow-root serialiseren
Het booleaanse kenmerk shadowrootserializable markeert een declaratieve shadow-root voor serialisatie via getHTML({ serializableShadowRoots: true }). Het neemt die root niet automatisch op in de gewone uitvoer van getHTML() of in de innerHTML van de host.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<template shadowrootmode="open" shadowrootserializable>…</template>shadowrootserializable is een booleaans kenmerk van het element template. Wanneer de parser een declaratieve shadow-root maakt op basis van shadowrootmode="open" of shadowrootmode="closed", stelt de aanwezigheid van dit kenmerk de serialisatievlag ervan in. shadowrootserializable alleen, zonder een geldige shadowrootmode, maakt geen shadow-root. Laat het kenmerk weg om de optie uit te schakelen; ook shadowrootserializable="false" geldt als aanwezig.
De aanroep host.getHTML({ serializableShadowRoots: true }) neemt de gemarkeerde shadow-root op als declaratieve template-markup met de inhoud ervan. De gewone aanroep host.getHTML() en het uitlezen van host.innerHTML laten de shadow-root van de host weg. Met de optie shadowRoots van getHTML() kun je expliciet roots voor serialisatie selecteren, ongeacht hun serialisatievlag.
Serialisatie is geen klonen: shadowrootserializable vervangt shadowrootclonable niet. Het is evenmin een mechanisme voor gegevensbescherming. Een gemarkeerde root in de modus closed kan ook verschijnen in de serialisatie van de host. Bewaar daar dus geen geheimen in de veronderstelling dat die modus export ervan voorkomt.
Laad het voorbeeld als HTML-document zodat de parser de declaratieve shadow-root maakt. Dezelfde markup toewijzen aan innerHTML maakt die root niet aan. De drie controles tonen dat de root standaard wordt weggelaten en dat het kenmerk en de inhoud ervan aanwezig zijn wanneer serialisatie is ingeschakeld.
Voorbeelden
<!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>Resultaat
true true true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.