Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes