Kod klawisza Tab
Tab wysyła event.key "Tab", event.code "Tab" i keyCode 9, z Shift lub bez.
Wszystkie wartości w skrócie
| Klawisz | event.code | event.key | keyCode | event.location |
|---|---|---|---|---|
| Tab | Tab | Tab | 9 | 0 (Zwykły) |
keyCode tak, jak wysyłają go Chrome i Edge w systemie Windows. Kolumny Mac (Chrome i Safari na Macu) i Firefox pokazują tylko liczby, które się różnią. Niektóre klawisze różnią się też zależnie od systemu, jak opisano niżej. event.which to zawsze ta sama liczba co keyCode. event.key dotyczy układu US bez wciśniętego klawisza Shift.
Naciśnij go tutaj
Kliknij tutaj, a potem naciśnij Tab
Używasz tylko klawiatury? Naciśnij Esc, a potem Tab, aby wyjść z pola klawiszy.
Kod, który reaguje na klawisz: Tab
document.addEventListener('keydown', (event) => {
if (event.key === 'Tab') {
// Twój kod tutaj
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'Tab') {
// Twój kod tutaj
}
});document.addEventListener('keydown', (event) => {
if (event.keyCode === 9) {
// Twój kod tutaj
}
});Której wartości użyć
Sprawdzaj event.key === 'Tab'. Jest jeden klawisz Tab i na każdym układzie wysyła tę samą wartość. event.code to także "Tab".
Shift + Tab nadal wysyła "Tab": Shift nie zmienia nazwy klawisza. Sprawdź event.shiftKey, aby odróżnić oba przypadki.
keyCode 9 nadal dociera w każdej przeglądarce, ale jest wycofywany.
Co sprawia kłopoty
keyup przychodzi do innego elementu
Tab przenosi fokus przy keydown. Dlatego keydown trafia do pola, które opuszczasz, a keyup do pola, do którego przechodzisz. Obsługa keyup w polu widzi Tab za każdym razem, gdy ktoś do niego przejdzie klawiszem Tab. Obsługuj Tab przy keydown.
Użytkownicy klawiatury utykają w moim elemencie
Jeśli wywołasz preventDefault() dla Tab, fokus się nie przesunie i użytkownicy klawiatury nie wyjdą. Bez innej drogi wyjścia to narusza kryterium WCAG 2.1.2 „Bez pułapki na klawiaturę”. Zatrzymuj Tab tylko z dobrego powodu, na przykład w oknie modalnym, które trzyma fokus w środku, dopóki jest otwarte. Wtedy daj wyraźne wyjście: Esc albo przycisk zamknięcia.
Tab przenosi fokus poza pole textarea zamiast wstawiać wcięcie
To zachowanie domyślne i większość użytkowników tego chce. W edytorze kodu możesz zamiast tego wstawiać tabulator:
if (event.key === 'Tab' && !event.shiftKey) {
event.preventDefault();
textarea.setRangeText('\t', textarea.selectionStart, textarea.selectionEnd, 'end');
}
Dodaj do tego drogę wyjścia, jak w naszym narzędziu do sprawdzania kodów klawiszy: najpierw naciśnij Esc, a wtedy Tab znów przechodzi dalej. setRangeText() nie dodaje wpisu do historii cofania, a document.execCommand('insertText', false, '\t') dodaje, choć jest wycofywane.
Ctrl+Tab i Alt+Tab nigdy nie docierają do strony
Zatrzymują je przeglądarka i komputer: Ctrl + Tab przełącza karty przeglądarki, a Alt + Tab (Cmd + Tab na Macu) przełącza aplikacje. Twoja strona może zobaczyć keydown klawisza Ctrl lub Alt, a potem nic. Gdy użytkownik wróci, klawisz modyfikujący może wyglądać, jakby nadal był wciśnięty, bo jego keyup trafił do innego okna. Zeruj stan klawiszy modyfikujących w zdarzeniu blur okna.
W Safari Tab pomija linki i przyciski
Domyślnie Safari na Macu przechodzi tylko między polami formularzy. Option + Tab dociera do każdego elementu. Możesz też włączyć w ustawieniach zaawansowanych Safari opcję „Klawisz Tab uaktywnia kolejno wszystkie elementy strony”. Sprawdzaj kolejność tabulacji z tą opcją włączoną i nie zakładaj, że użytkownicy Maca dojdą do przycisku samym Tab.
Kolejność tabulacji
Tab podąża za kolejnością elementów w HTML. tabindex="0" dodaje element do tej kolejności, a tabindex="-1" go z niej usuwa. Unikaj liczb dodatnich: elementy z takimi wartościami dostają fokus przed pozostałymi, co może zmylić użytkownika.