CKTIS / HTML
shadowrootmode — declaratief Shadow DOM
Met het attribuut shadowrootmode op template kan de HTML-parser een declaratieve shadow-root maken. De waarden open en closed bepalen hoe die root toegankelijk is.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<template shadowrootmode="open|closed">…</template>shadowrootmode is een enumeratief attribuut van template, geen boolean attribuut. Het accepteert open of closed. Als het attribuut ontbreekt, leeg is of een ongeldige waarde heeft, geldt de status None: het attribuut alleen activeert dan geen aanmaak van een shadow-root.
Tijdens het parseren van een HTML-document maakt een geldige declaratie een shadow-root op het bovenliggende element, als dat element als host voor Shadow DOM kan dienen. De inhoud van de declaratie komt in de shadow-root terecht; het template zelf wordt geen DOM-kind van de host. Als de host al een shadow-root heeft of het toevoegen ervan niet is toegestaan, laat de parser een gewone template staan.
Met de modus open kan de root worden opgehaald via host.shadowRoot; bij closed retourneert die eigenschap null. Beide modi maken Shadow DOM — closed betekent niet dat de inhoud niet wordt weergegeven.
Dit is een mechanisme van de parser, geen schakelaar die achteraf werkt: shadowrootmode toevoegen aan een bestaande template maakt geen shadow-root. De markup toewijzen aan innerHTML activeert declaratief Shadow DOM evenmin. Open het voorbeeld als HTML-document in plaats van het via innerHTML in te voegen.
Voorbeelden
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Declarative shadow DOM</title>
<div id="host"><template shadowrootmode="open"><span>Hello</span></template></div>
<pre id="result"></pre>
<script>
const host = document.getElementById('host');
document.getElementById('result').textContent = [
host.shadowRoot.mode,
host.shadowRoot.querySelector('span').textContent,
String(host.querySelector('template'))
].join('\n');
</script>
</html>Resultaat
open Hello null
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.