Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

termine o valore HTML: tabindex

L’attributo `tabindex` controlla la possibilità di ricevere focus e la partecipazione alla navigazione sequenziale da tastiera.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

<div tabindex="-1">…</div>

tabindex accetta un intero valido. 0 esprime la preferenza dell’autore per includere l’elemento secondo struttura e ambito, mentre -1 preferisce focus da script o clic senza partecipazione a Tab; lo user agent può ignorare tali preferenze per convenzioni di piattaforma.

La proprietà tabIndex espone il valore DOM e focus() può focalizzare un elemento con valore negativo. Nessun valore tabindex rende non focalizzabile un elemento intrinsecamente focalizzabile; usa disabled per un controllo o inert per un sottoalbero quando la semantica lo richiede.

Evita valori positivi come tabindex="1", che creano un ordine separato difficile da mantenere. Gli elementi nativi button e a con indirizzo hanno già comportamento da tastiera; rendere focalizzabile un div non aggiunge ruolo né attivazione con Invio o Spazio.

L’esempio assegna al contenitore tabindex="-1": la proprietà restituisce -1 e, dopo focus(), l’elemento diventa document.activeElement anche se non partecipa alla normale sequenza Tab.

Esempi

<!doctype html><meta charset="utf-8"><button id="a">A</button><div id="x" tabindex="-1">Target</div><output id="result"></output><script>x.focus();result.textContent=`tabIndex=${x.tabIndex}; focused=${document.activeElement===x}`;</script>

Risultato

tabIndex=-1; focused=true

L’esempio eseguito verifica il confine tra focus programmatico e navigazione sequenziale per un valore negativo.

Fonti