Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

shadowrootslotassignment — asignación de nodos a slots

El atributo shadowrootslotassignment de template selecciona cómo se asignan nodos a los slots de una raíz shadow declarativa: automáticamente con named o de forma explícita con manual.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

<template shadowrootmode="open" shadowrootslotassignment="named|manual">…</template>

shadowrootslotassignment es un atributo enumerado de template que configura la asignación a slots al crear una raíz shadow declarativa. Úsalo junto con un shadowrootmode válido; por sí solo no crea una raíz. En la sintaxis, named|manual significa que se debe elegir uno de los valores, no que haya que escribir literalmente ese texto.

El valor named activa la coincidencia automática entre el atributo slot de un elemento hijo del host y el atributo name de un elemento slot en el árbol shadow. Si se omite el atributo, está vacío o tiene un valor no válido, se selecciona el estado named. No es un atributo booleano: su mera presencia no activa el modo manual.

El valor manual desactiva la asignación automática basada en nombres. Un script asigna los nodos mediante HTMLSlotElement.assign(). Hasta que un slot tenga nodos asignados, representa su propio contenido alternativo. En el ejemplo, assign(item) asigna un elemento que es hijo directo del host.

El analizador lee esta configuración al crear la raíz; cambiar el atributo más tarde no reconfigura una raíz existente. El ejemplo requiere compatibilidad con este atributo, no solo con Shadow DOM declarativo.

Ejemplos

<!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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes