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

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.

Fontes