Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes