CKTIS / HTML
shadowrootserializable — einen deklarativen Shadow Root serialisieren
Das boolesche Attribut shadowrootserializable kennzeichnet einen deklarativen Shadow Root für die Serialisierung mit getHTML({ serializableShadowRoots: true }). Es fügt diesen Root nicht automatisch in die gewöhnliche Ausgabe von getHTML() oder in innerHTML des Hosts ein.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<template shadowrootmode="open" shadowrootserializable>…</template>shadowrootserializable ist ein boolesches Attribut des Elements template. Erstellt der Parser aus shadowrootmode="open" oder shadowrootmode="closed" einen deklarativen Shadow Root, setzt das Vorhandensein dieses Attributs dessen Serialisierungskennzeichen. shadowrootserializable allein, ohne gültiges shadowrootmode, erstellt keinen Shadow Root. Um die Option zu deaktivieren, lasse das Attribut weg; auch shadowrootserializable="false" gilt als vorhanden.
Der Aufruf host.getHTML({ serializableShadowRoots: true }) nimmt den gekennzeichneten Shadow Root als deklaratives template-Markup einschließlich seines Inhalts auf. Ein gewöhnliches host.getHTML() und das Auslesen von host.innerHTML lassen den Shadow Root des Hosts aus. Mit der Option shadowRoots von getHTML() kannst du unabhängig vom Serialisierungskennzeichen ausdrücklich Roots für die Serialisierung auswählen.
Serialisierung ist kein Klonen: shadowrootserializable ersetzt shadowrootclonable nicht. Es ist auch kein Datenschutzmechanismus. Ein gekennzeichneter Root im Modus closed kann ebenfalls in der Serialisierung seines Hosts erscheinen. Lege dort also keine Geheimnisse ab, in der Annahme, dieser Modus verhindere ihren Export.
Lade das Beispiel als HTML-Dokument, damit der Parser den deklarativen Shadow Root erstellt. Wenn du dasselbe Markup innerHTML zuweist, wird er nicht erstellt. Die drei Prüfungen zeigen, dass der Root standardmäßig ausgelassen wird und dass sein Attribut und sein Inhalt bei aktivierter Serialisierung enthalten sind.
Beispiele
<!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>Ergebnis
true true true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.