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.