Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

HTMLElement.tabIndex — focus e ordine di navigazione

La proprietà tabIndex rispecchia l’attributo tabindex e influisce sulla possibilità di ricevere il focus e sull’ordine di navigazione da tastiera.

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

Sintassi

element.tabIndex;
element.tabIndex = integer;

HTMLElement.tabIndex legge un numero intero; assegnarle un valore scrive l’attributo tabindex. In assenza di un valore valido, il valore letto per impostazione predefinita dipende dall’elemento: 0 per button, ma -1 per div.

0 indica che l’elemento dovrebbe rientrare nel normale ordine di navigazione con Tab, ma non garantisce che sia raggiungibile con quel tasto. Un valore negativo di solito lo esclude da quell’ordine, senza impedire a focus() di dargli il focus se l’elemento soddisfa le altre condizioni per riceverlo. Nessuno dei due valori rende possibile dare il focus a un elemento inerte o non renderizzato, né a un controllo di un modulo disabilitato. Anche le preferenze dell’utente possono influire sulla navigazione con Tab. I valori positivi stabiliscono una priorità all’interno di un ambito di navigazione; è preferibile usare 0 e -1.

Il valore letto, da solo, non dimostra che l’elemento possa ricevere il focus. Assegnare -1 non rimuove l’attributo; usa removeAttribute('tabindex').

Esempi

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();

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti