Codice del tasto Tab
Tab invia event.key "Tab", event.code "Tab" e keyCode 9, con o senza Maiusc.
Tutti i valori in breve
| Tasto | event.code | event.key | keyCode | event.location |
|---|---|---|---|---|
| Tab | Tab | Tab | 9 | 0 (Standard) |
Valori di keyCode inviati da Chrome ed Edge su Windows. Le colonne Mac (Chrome e Safari) e Firefox mostrano solo i valori diversi. Alcuni valori cambiano anche in base al sistema, come spiegato qui sotto. event.which ha sempre lo stesso valore di keyCode. Il valore di event.key si riferisce a una tastiera inglese (US) senza Maiusc.
Premilo qui
Fai click qui, poi premi Tab
Usi solo la tastiera? Premi Esc, poi Tab, per uscire dal riquadro.
Codice per reagire a Tab
document.addEventListener('keydown', (event) => {
if (event.key === 'Tab') {
// Il tuo codice qui
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'Tab') {
// Il tuo codice qui
}
});document.addEventListener('keydown', (event) => {
if (event.keyCode === 9) {
// Il tuo codice qui
}
});Quale valore usare
Controlla event.key === 'Tab'. C’è un solo tasto Tab e invia lo stesso valore con ogni layout. Anche event.code è "Tab".
Maiusc + Tab invia ancora "Tab": Maiusc non cambia il nome del tasto. Controlla event.shiftKey per distinguere i due casi.
keyCode 9 arriva ancora in ogni browser, ma è deprecato.
Dove si sbaglia di solito
Il keyup arriva su un altro elemento
Tab sposta il focus al keydown. Quindi il campo di partenza riceve il keydown e quello di arrivo riceve il keyup. Un gestore di keyup su un campo vede Tab ogni volta che qualcuno ci arriva con Tab. Gestisci Tab al keydown.
Chi usa la tastiera resta bloccato nel mio widget
Se chiami preventDefault() su Tab, il focus non si sposta mai e chi usa la tastiera non riesce a uscire. Senza un’altra via d’uscita, questo non rispetta il criterio WCAG 2.1.2, Nessun impedimento all’uso della tastiera. Ferma Tab solo per un buon motivo, come una finestra modale che tiene il focus al suo interno finché è aperta. Poi offri un’uscita chiara: Esc o un pulsante di chiusura.
Tab nella mia textarea esce dal campo invece di fare un rientro
È il comportamento predefinito, e la maggior parte delle persone lo vuole. In un editor di codice puoi invece inserire una tabulazione:
if (event.key === 'Tab' && !event.shiftKey) {
event.preventDefault();
textarea.setRangeText('\t', textarea.selectionStart, textarea.selectionEnd, 'end');
}
Abbinalo a una via d’uscita, come fa lo strumento Codice di un tasto (keycode): prima premi Esc, poi Tab passa oltre. setRangeText() non aggiunge nulla alla cronologia di annullamento. document.execCommand('insertText', false, '\t') invece sì, anche se è deprecato.
Ctrl+Tab e Alt+Tab non arrivano mai alla pagina
Li tengono il browser e il computer: Ctrl + Tab cambia scheda del browser, Alt + Tab (Comando + Tab su Mac) cambia app. La tua pagina può vedere il keydown di Ctrl o Alt e poi nulla. Quando si torna, un modificatore può sembrare bloccato perché il suo keyup è andato a un’altra finestra. Azzera lo stato dei modificatori con l’evento blur della finestra.
In Safari, Tab salta link e pulsanti
Per impostazione predefinita Safari su Mac si sposta solo tra i campi dei moduli. Premi Opzione + Tab per raggiungere tutti gli elementi. Puoi anche aprire Safari > Impostazioni > Avanzate e attivare “Premi Tabulatore per evidenziare gli elementi della pagina web”. Prova l’ordine dei tab con quell’opzione attiva e non dare per scontato che chi usa un Mac raggiunga un pulsante solo con Tab.
Ordine di navigazione con Tab
Tab segue l’ordine degli elementi nell’HTML. tabindex="0" aggiunge un elemento a quell’ordine e tabindex="-1" lo toglie. Evita i numeri positivi: saltano davanti a tutto il resto e confondono le persone.