CKTIS / HTML
termo ou valor HTML: tabindex
O atributo `tabindex` controla a capacidade de receber foco e a participação na navegação sequencial por teclado.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<div tabindex="-1">…</div>tabindex aceita um número inteiro válido. 0 exprime a preferência do autor por inclusão segundo estrutura e âmbito, enquanto -1 prefere foco por script ou clique sem participação em Tab; o agente do utilizador pode ignorar estas preferências por convenções da plataforma.
A propriedade tabIndex expõe o valor DOM e focus() pode focar um elemento com valor negativo. Nenhum valor tabindex torna não focável um elemento intrinsecamente focável; usa disabled para um controlo ou inert para uma subárvore quando essa semântica se aplica.
Evita valores positivos como tabindex="1", que criam uma ordem separada difícil de manter. Elementos nativos button e a com endereço já têm comportamento de teclado; tornar um div focável não acrescenta função nem ativação com Enter ou Espaço.
O exemplo dá ao contentor tabindex="-1": a propriedade devolve -1 e, após focus(), o elemento torna-se document.activeElement embora não participe na sequência Tab normal.
Exemplos
<!doctype html><meta charset="utf-8"><button id="a">A</button><div id="x" tabindex="-1">Target</div><output id="result"></output><script>x.focus();result.textContent=`tabIndex=${x.tabIndex}; focused=${document.activeElement===x}`;</script>Resultado
tabIndex=-1; focused=true
O exemplo executado verifica a fronteira entre foco programático e navegação sequencial para um valor negativo.