CKTIS / HTML
shadowrootclonable — een declaratieve shadow root klonen
Het boolean attribuut shadowrootclonable van een template-element markeert een declaratieve shadow root als kloonbaar. Daardoor kan het kopiëren van het host-element ook de bijbehorende shadow tree meenemen.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<template shadowrootmode="open" shadowrootclonable>…</template>shadowrootclonable is een boolean attribuut van template, dat samen met shadowrootmode wordt gebruikt. Bij het maken van een declaratieve shadow root stelt de parser de kloonbaarheidsvlag in op basis van de aanwezigheid van het attribuut. Zonder het attribuut is de vlag false; het attribuut alleen maakt geen shadow root aan.
Als de root kloonbaar is, kopieert host.cloneNode(true) ook de bijbehorende shadow tree. Dit is niet hetzelfde als de gewone inhoud van een template kopiëren met template.content.cloneNode(true): hierbij wordt de host gekopieerd met de al aangemaakte shadow root.
Aanwezigheid schakelt de optie in: shadowrootclonable="false" schakelt haar ook in en is geen geldige manier om een boolean attribuut uit te schakelen. Laat het attribuut weg om deze optie in de declaratie uit te schakelen. shadowrootclonable vervangt shadowrootserializable niet: het klonen van nodes en HTML-serialisatie zijn aparte mechanismen.
Voor het voorbeeld is een browser nodig die declaratieve shadow roots en dit attribuut ondersteunt. Open het volledige HTML-document in plaats van de markup via innerHTML in te voegen. Met de modus open kun je de kopie inspecteren via copy.shadowRoot; de gekopieerde host hoeft niet aan het document te worden toegevoegd.
Voorbeelden
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Shadow root cloning</title>
<div id="host"><template shadowrootmode="open" shadowrootclonable><span>Hello</span></template></div>
<pre id="result"></pre>
<script>
const host = document.getElementById('host');
const copy = host.cloneNode(true);
document.getElementById('result').textContent =
copy.shadowRoot?.textContent ?? 'No shadow root';
</script>
</html>Resultaat
Hello
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.