CKTIS / HTML
shadowrootslotassignment — atribuição de nós a slots
O atributo shadowrootslotassignment de template seleciona a forma como os nós são atribuídos a slots numa shadow root declarativa: automaticamente com named ou explicitamente com manual.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<template shadowrootmode="open" shadowrootslotassignment="named|manual">…</template>shadowrootslotassignment é um atributo enumerado de template que configura a atribuição a slots quando uma shadow root declarativa é criada. Utilize-o com um shadowrootmode válido; por si só, não cria uma root. Na sintaxe, named|manual significa que se escolhe um dos valores, e não que se escreve literalmente esse texto.
O valor named ativa a correspondência automática entre o atributo slot de um elemento filho do host e o atributo name de um elemento slot na árvore shadow. Se o atributo for omitido, estiver vazio ou tiver um valor inválido, é selecionado o estado named. Não é um atributo booleano: a sua mera presença não ativa o modo manual.
O valor manual desativa a atribuição automática baseada em nomes. Um script atribui os nós através de HTMLSlotElement.assign(). Enquanto um slot não tiver nós atribuídos, representa o seu próprio conteúdo alternativo. No exemplo, assign(item) atribui um elemento que é filho direto do host.
A definição é lida quando o analisador cria a root; alterar o atributo posteriormente não reconfigura uma root existente. O exemplo requer suporte para este atributo, não apenas para Shadow DOM declarativo.
Exemplos
<!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>Resultado
0 -> 1: Hello
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.