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

CKTIS / HTML

shadowrootdelegatesfocus — delegação do foco no Shadow DOM declarativo

O atributo booleano shadowrootdelegatesfocus de template ativa a delegação do foco numa raiz shadow criada de forma declarativa. Permite que o foco passe do anfitrião para um elemento interno adequado; por si só, não cria uma raiz shadow nem coloca automaticamente o foco em nenhum elemento.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

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

shadowrootdelegatesfocus é um atributo booleano de template. Ao criar uma raiz shadow declarativa, a sua presença ativa a delegação do foco e a sua ausência desativa-a. Também é necessário um shadowrootmode válido: open ou closed. Este atributo, por si só, não cria uma raiz shadow.

Quando o anfitrião recebe um pedido de foco, por exemplo através de host.focus(), o navegador pode transferir o foco para um elemento adequado na sua árvore shadow. No exemplo, input é o único elemento desse tipo. O atributo não funciona como autofocus: a sua presença não coloca nenhum elemento em foco quando a página é carregada.

As formas válidas incluem shadowrootdelegatesfocus, shadowrootdelegatesfocus="" e shadowrootdelegatesfocus="shadowrootdelegatesfocus". O valor "false" não é válido para um atributo booleano e não desativa a funcionalidade: a presença do atributo continua a ativá-la. Para criar uma raiz sem delegação do foco, omita o atributo da declaração.

O analisador lê esta opção ao criar a raiz; não é uma definição dinâmica de uma raiz existente. No exemplo, open permite o acesso através de host.shadowRoot. Depois de clicar em Run, document.activeElement identifica o anfitrião, enquanto root.activeElement identifica o input interno; ambas as comparações resultam em true.

Exemplos

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

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