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

CKTIS / JavaScript

HTMLElement.tabIndex — foco e ordem de navegação

A propriedade tabIndex reflete o atributo tabindex e influencia a possibilidade de receber foco e a ordem de navegação pelo teclado.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

element.tabIndex;
element.tabIndex = integer;

HTMLElement.tabIndex lê um número inteiro; uma atribuição escreve no atributo tabindex. Sem um valor válido, o valor lido por predefinição depende do elemento: 0 para button, mas -1 para div.

0 indica que o elemento deve integrar a ordem de navegação habitual com a tecla Tab, mas não garante que seja possível chegar ao elemento com essa tecla. Um valor negativo normalmente exclui-o dessa ordem, sem impedir que focus() lhe dê o foco se o elemento reunir as restantes condições para o receber. Nenhum destes dois valores permite dar o foco a um elemento inerte ou não renderizado, nem a um controlo de formulário desativado. As preferências do utilizador também podem influenciar a navegação com Tab. Os valores positivos estabelecem uma prioridade dentro de um âmbito de navegação; prefira 0 e -1.

A leitura, por si só, não prova que o elemento possa receber foco. Atribuir -1 não remove o atributo; use removeAttribute('tabindex').

Exemplos

const element = document.createElement('div');
const report = () => console.log(JSON.stringify([
  element.tabIndex,
  element.getAttribute('tabindex')
]));

report();
element.tabIndex = 0;
report();
element.tabIndex = -1;
report();
element.removeAttribute('tabindex');
report();

Resultado

[-1,null]
[0,"0"]
[-1,"-1"]
[-1,null]

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