CKTIS / JavaScript
HTMLElement.tabIndex — foco y orden de navegación
La propiedad tabIndex refleja el atributo tabindex e influye en la posibilidad de recibir el foco y en el orden de navegación con el teclado.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
element.tabIndex;
element.tabIndex = integer;HTMLElement.tabIndex lee un número entero; asignarle un valor escribe el atributo tabindex. Si no hay un valor válido, la lectura predeterminada depende del elemento: 0 para button, pero -1 para div.
0 indica que el elemento debería formar parte del orden habitual de tabulación, pero no garantiza que se pueda llegar a él con Tab. Un valor negativo normalmente lo deja fuera de ese orden, sin impedir que focus() le dé el foco si el elemento reúne las demás condiciones para recibirlo. Ninguno de estos dos valores permite dar el foco a un elemento inerte o que no se renderiza, ni a un control de formulario deshabilitado. Las preferencias del usuario también pueden afectar a la navegación con Tab. Los valores positivos establecen una prioridad dentro de un ámbito de navegación; es preferible usar 0 y -1.
La lectura por sí sola no demuestra que el elemento pueda recibir el foco. Asignar -1 no elimina el atributo; usa removeAttribute('tabindex').
Ejemplos
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]
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.