CKTIS / HTML
shadowrootslotassignment — assegnazione dei nodi agli slot
L’attributo shadowrootslotassignment di template seleziona il modo in cui i nodi vengono assegnati agli slot in una shadow root dichiarativa: automaticamente con named o esplicitamente con manual.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<template shadowrootmode="open" shadowrootslotassignment="named|manual">…</template>shadowrootslotassignment è un attributo enumerato di template che configura l’assegnazione agli slot quando viene creata una shadow root dichiarativa. Usalo insieme a un shadowrootmode valido; da solo non crea una root. Nella sintassi, named|manual indica che va scelto un valore, non che il testo debba essere inserito alla lettera.
Il valore named attiva la corrispondenza automatica tra l’attributo slot di un figlio dell’host e l’attributo name di un elemento slot nell’albero shadow. Se l’attributo è omesso, vuoto o non valido, viene selezionato lo stato named. Non è un attributo booleano: la sua sola presenza non attiva la modalità manuale.
Il valore manual disattiva l’assegnazione automatica basata sui nomi. Uno script assegna i nodi tramite HTMLSlotElement.assign(). Finché uno slot non ha nodi assegnati, rappresenta il proprio contenuto di fallback. Nell’esempio, assign(item) assegna un elemento che è figlio diretto dell’host.
L’impostazione viene letta quando il parser crea la root; modificarla in seguito non riconfigura una root esistente. L’esempio richiede il supporto di questo attributo, non soltanto dello Shadow DOM dichiarativo.
Esempi
<!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>Risultato
0 -> 1: Hello
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.