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

CKTIS / HTML

shadowrootdelegatesfocus — delegación del foco en Shadow DOM declarativo

El atributo booleano shadowrootdelegatesfocus de template activa la delegación del foco para una raíz shadow creada de forma declarativa. Permite que el foco pase del host a un elemento interno adecuado; por sí solo no crea una raíz shadow ni enfoca nada automáticamente.

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

Sintaxis

<template shadowrootmode="open" shadowrootdelegatesfocus>…</template>

shadowrootdelegatesfocus es un atributo booleano de template. Al crear una raíz shadow declarativa, su presencia activa la delegación del foco y su ausencia la desactiva. También se necesita un shadowrootmode válido: open o closed. El atributo por sí solo no crea una raíz shadow.

Cuando el host recibe una petición de foco, por ejemplo mediante host.focus(), el navegador puede transferir el foco a un elemento adecuado de su árbol shadow. En el ejemplo, input es el único elemento de este tipo. El atributo no funciona como autofocus: su presencia no enfoca nada cuando se carga la página.

Entre las formas válidas están shadowrootdelegatesfocus, shadowrootdelegatesfocus="" y shadowrootdelegatesfocus="shadowrootdelegatesfocus". El valor "false" no es válido para un atributo booleano y no desactiva la función: si el atributo está presente, la activa. Para crear una raíz sin delegación del foco, omite el atributo de la declaración.

El analizador lee esta opción al crear la raíz; no es un ajuste dinámico de una raíz ya existente. En el ejemplo, open permite acceder mediante host.shadowRoot. Tras hacer clic en Run, document.activeElement señala el host, mientras que root.activeElement señala el input interno; ambas comparaciones dan true.

Ejemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Focus delegation</title>
<div id="host">
  <template shadowrootmode="open" shadowrootdelegatesfocus>
    <label>Name <input id="name" type="text"></label>
  </template>
</div>
<button id="run" type="button">Run</button>
<pre id="result"></pre>
<script>
  const host = document.getElementById('host');
  document.getElementById('run').addEventListener('click', () => {
    host.focus();
    const root = host.shadowRoot;
    document.getElementById('result').textContent = [
      document.activeElement === host,
      root.activeElement === root.getElementById('name')
    ].join('\n');
  });
</script>
</html>

Resultado

true
true

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