Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti