KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen