CKTIS / HTML
shadowrootslotassignment — nodes aan slots toewijzen
Het attribuut shadowrootslotassignment van template bepaalt hoe nodes aan slots in een declaratieve shadow root worden toegewezen: automatisch met named of expliciet handmatig met manual.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<template shadowrootmode="open" shadowrootslotassignment="named|manual">…</template>shadowrootslotassignment is een enumeratieattribuut van template dat de slottoewijzing instelt wanneer een declaratieve shadow root wordt gemaakt. Gebruik het met een geldige shadowrootmode; op zichzelf maakt het geen root aan. In de syntaxis betekent named|manual dat je één waarde kiest, niet dat je die tekst letterlijk invoert.
De waarde named schakelt automatische overeenkomst in tussen het slot-attribuut van een kind van de host en het name-attribuut van een slot-element in de shadow tree. Als het attribuut ontbreekt, leeg is of een ongeldige waarde heeft, wordt de toestand named gekozen. Dit is geen booleaans attribuut: alleen de aanwezigheid ervan schakelt de handmatige modus niet in.
De waarde manual schakelt automatische toewijzing op basis van namen uit. Een script wijst nodes toe met HTMLSlotElement.assign(). Zolang aan een slot geen nodes zijn toegewezen, toont het zijn eigen fallback-inhoud. In het voorbeeld wijst assign(item) een element toe dat een rechtstreeks kind van de host is.
De instelling wordt gelezen wanneer de parser de root maakt; een latere wijziging van het attribuut configureert een bestaande root niet opnieuw. Het voorbeeld vereist ondersteuning voor dit attribuut, niet alleen voor declaratief Shadow DOM.
Voorbeelden
<!doctype html>
<meta charset="utf-8">
<title>Manual slot assignment</title>
<div id="host">
<template shadowrootmode="open" shadowrootslotassignment="manual">
<slot>Fallback</slot>
</template>
<span id="item">Hello</span>
</div>
<pre id="result"></pre>
<script>
const host = document.getElementById('host');
const item = document.getElementById('item');
const slot = host.shadowRoot.querySelector('slot');
const before = slot.assignedNodes().length;
slot.assign(item);
const after = slot.assignedNodes().length;
document.getElementById('result').textContent =
`${before} -> ${after}: ${slot.assignedNodes()[0].textContent}`;
</script>Resultaat
0 -> 1: 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.