2.1.2 Brak pułapki na klawiaturę (ang.) No Keyboard Trap
Spis treści
Istota i cel kryterium
Wytyczna ta stanowi absolutny fundament swobodnej nawigacji. Gwarantuje ona, że każda osoba korzystająca z interfejsu klawiatury może nie tylko wejść do dowolnego elementu interaktywnego, ale również bez przeszkód go opuścić. Realizacja tego kryterium eliminuje sytuacje, w których użytkownik zostaje „uwięziony” wewnątrz konkretnej sekcji strony (np. w oknie modalnym lub wtyczce społecznościowej) i nie może kontynuować przeglądania treści bez użycia myszy.
Zastosuj tę zasadę, aby zapewnić płynny przepływ fokus na całej stronie. Jeśli komponent wymaga niestandardowych klawiszy do wyjścia, Twoim obowiązkiem jest poinformowanie o tym użytkownika, zanim tam trafi.
Definicja w j. angielskim
Definicja dostępna pod adresem:
https://www.w3.org/WAI/WCAG22/quickref/#no-keyboard-trap
Definicja w j. polskim
Definicja dostępna pod adresem:
https://www.w3.org/Translations/WCAG21-pl/#bez-pu-apki-na-klawiature
Słownik pojęć
- Interfejs klawiatury (ang.) keyboard Interface
-
–
mechanizm używany przez oprogramowanie do odbierania danych wejściowych w postaci naciśnięć klawiszy. Co istotne, interfejs ten może być obsługiwany przez fizyczną klawiaturę, ale także przez oprogramowanie do rozpoznawania mowy, systemy (ang.) sip-and-puff czy klawiatury ekranowe.
- Fokus (ang.) focus
-
–
stan aktywnego wyróżnienia elementu interfejsu (takiego jak odnośnik, przycisk czy pole formularza), który wskazuje gotowość komponentu na przyjęcie akcji lub danych wprowadzanych przez użytkownika.
Wpływ na dostępność (Kogo wspierasz?)
- Osoby niewidome: Korzystają one z czytników ekranu (np. NVDA), które bazują na nawigacji klawiaturowej. Zablokowanie fokusu sprawia, że reszta serwisu staje się dla nich „niewidzialna”.
- Osoby z niepełnosprawnościami ruchowymi: Użytkownicy z drżeniem rąk lub ograniczoną precyzją ruchów używają specjalistycznych emulatorów klawiatury. Pułapka klawiaturowa uniemożliwia im jakąkolwiek dalszą interakcję ze stroną.
- Osoby słabowidzące: Często mają trudności ze śledzeniem małego kursora myszy na ekranie i preferują przewidywalną nawigację klawiszową.
- Użytkownicy z zaburzeniami poznawczymi: Nagła utrata kontroli nad nawigacją i brak jasnej drogi wyjścia powoduje dezorientację oraz silną frustrację.
- Osoby w sytuacjach tymczasowych: Każdy, kto korzysta z uszkodzonej myszy, (ang.) trackpadu lub po prostu preferuje szybkość pracy z klawiaturą, zyska na przewidywalności interfejsu.
Zasady wdrażania i wymagania techniczne
Aby spełnić kryterium 2.1.2, trzymaj się następujących reguł:
- Standardowe i niestandardowe metody wyjścia: W większości przypadków klawisze Tab oraz Shift + Tab muszą umożliwiać sprawne wejście i wyjście z komponentu. Klawisz Esc powinien być domyślnym sposobem zamykania wszelkich nakładek. Jeśli do opuszczenia elementu wymagane jest coś więcej niż standardowe klawisze, użytkownik musi zostać wyraźnie o tym poinformowany przed wejściem w interakcję z danym komponentem.
- Zarządzanie oknami modalnymi: Okna typu (ang.) Modal mogą celowo ograniczać fokus do swojej zawartości, ale muszą oferować klawiaturowy sposób na ich zamknięcie (np. klawisz Esc lub dostępny przycisk „Zamknij”), co przywróci fokus do miejsca, z którego otwarto okno.
- Osadzone aplikacje i widżety: W przypadku umieszczenia na stronie zewnętrznych zasobów w
<iframe>(np. odtwarzaczy, gier lub map) upewnij się, że nie przechwytują one fokusu na stałe. Jeśli do opuszczenia takiego elementu potrzebna jest specyficzna kombinacja klawiszy (np. Ctrl + M), instrukcja ta musi być widoczna i dostępna cyfrowo jeszcze przed wejściem w interakcję z modułem.
Wyjątki i sytuacje szczególne
Wymóg ten nie posiada wyjątków co do samej możliwości wyjścia, natomiast dopuszcza stosowanie niestandardowych kombinacji klawiszy (np. Ctrl + M), ale wyłącznie pod warunkiem, że użytkownik zostanie wyraźnie poinstruowany o alternatywnej, skutecznej metodzie opuszczenia danego obszaru.
Przykłady implementacji
Najczęstsze błędy
- Brak wyjścia z komponentu za pomocą klawiatury: Fokus wchodzi do komponentu (np. kalendarza, menu, osadzonego odtwarzacza), ale nie da się go z niego wyprowadzić ani standardową metodą (np. Tab, Shift + Tab, strzałki, Esc), ani żadną inną metodą obsługiwaną z klawiatury. Częsta przyczyna: przycisk „Zamknij” jest wyłączony z obsługi klawiatury (np. przez
tabindex="-1"), a komponent nie ma innej drogi wyjścia. - Niestandardowa metoda wyjścia bez instrukcji: Komponent przejmuje klawisz Tab (np. edytor tekstu sformatowanego używa go do wcięć), a użytkownik nie dowiaduje się, jakim skrótem może opuścić komponent. Instrukcja powinna być dostępna przed komponentem lub w nim, np. wyświetlana po wejściu fokusu do komponentu.
- Okno modalne bez możliwości zamknięcia z klawiatury: Zapętlenie fokusu wewnątrz okna modalnego (z ostatniego elementu na pierwszy) jest dopuszczalne i zalecane we wzorcu okna dialogowego ARIA APG, ale tylko wtedy, gdy okno da się zamknąć z klawiatury, np. klawiszem Esc albo przyciskiem „Anuluj” lub „Zamknij”. Pętla bez takiej możliwości jest pułapką klawiaturową ((ang.) keyboard trap).
- F10, uwięzienie w osadzonej treści: Fokus wchodzi do treści osadzonej na stronie (np.
<iframe>, wtyczki, widżetu zewnętrznego dostawcy) i nie da się z niej wrócić klawiaturą do reszty strony. Ten błąd dotyczy każdej części strony, także treści zewnętrznych i takich, których nie obejmuje deklaracja zgodności, bo pułapka blokuje użytkownikowi całą stronę.
Najlepsze praktyki
- Stawiaj na natywny HTML: Wykorzystuj znacznik
<dialog>, który posiada wbudowane mechanizmy poprawnego zarządzania fokusem. - Wizualizuj aktywność: Zawsze zapewnij wyraźny wskaźnik fokusu, aby użytkownik wiedział, gdzie się znajduje.
- Projektuj wzorcowo: Implementuj sprawdzone wzorce (ang.) WAI-ARIA Authoring Practices dla wszystkich niestandardowych komponentów.
- Testuj na wczesnym etapie: Regularne sprawdzanie nawigacji samą klawiaturą pozwala wykryć pułapki przed wdrożeniem skomplikowanej logiki.
Metody testowania
- Testowanie manualne: Odłóż mysz i sprawdź, czy możesz przejść przez wszystkie interaktywne elementy za pomocą klawiszy Tab oraz Shift + Tab i czy zawsze masz drogę wyjścia.
- NVDA: Sprawdź, czy instrukcja wyjścia z komponentu jest odczytywana (np. powiązana przez
aria-describedby). Samej pułapki nie oceniaj z włączonym czytnikiem – w trybie przeglądania strzałki przesuwają kursor czytnika poza komponent. - ANDI.js: Wykorzystaj moduł (ang.) „Tab Order”, aby sprawdzić, czy ścieżka nawigacji nie wpada w nieskończoną pętlę bez możliwości wyjścia.
- Narzędzie deweloperskie (ang.) Developer Tools: Sprawdź w drzewie DOM, czy skrypty obsługujące zdarzenia klawiatury (np.
onkeydown) nie blokują domyślnego zachowania przeglądarki w sposób uniemożliwiający nawigację.
Sprawdź swoją wiedzę
W linku poniżej znajduje się 5 interaktywnych elementów. Twoim zadaniem jest sprawdzenie, czy z każdego komponentu, do którego trafi fokus, da się wyjść samą klawiaturą.
Jak to sprawdzić?
- Użyj klawisza Tab, aby przejść do elementu.
- Aktywuj element (przycisk, pole formularza).
- Spróbuj wyjść, używając Tab, Shift + Tab, strzałek lub Esc.
- Jeśli te klawisze nie wyprowadzają fokusu, sprawdź, czy strona lub komponent informuje, jak wyjść (np. instrukcja przy polu). Jeśli informuje, a opisany sposób działa, to nie jest pułapka.
- Jeśli nie możesz wyjść klawiaturą i nic nie mówi, jak to zrobić, kryterium 2.1.2 nie jest spełnione.
Proponowane narzędzia: Klawiatura (Tab, Shift + Tab, strzałki, Esc, Enter), Narzędzie deweloperskie (ang.) Developer Tools, ANDI.js
Notatka: Zanim zajrzysz do rozwiązania, uruchom wybrane narzędzia testowe i zapisz swoje wnioski na kartce.
Uwaga: Testuj bez czytnika ekranu. W trybie przeglądania NVDA strzałki przesuwają kursor czytnika, a Esc przełącza tryb, więc pułapki na stronie możesz nie zauważyć.
#1 BŁĄD
Problem: Modal nie ma przycisku zamknięcia i nie obsługuje klawisza Esc. Fokus jest zamknięty wewnątrz ((ang.) keyboard trap) bez możliwości wyjścia.
Dlaczego: Użytkownik klawiatury jest całkowicie uwięziony. Jedyny sposób na wyjście to odświeżenie strony (F5) lub użycie myszy.
Naprawa: Dodaj przycisk zamknięcia i obsługę klawisza Esc. Ograniczenie fokusu do okna (tzw. focus trap) jest dopuszczalne, ale musi istnieć sposób wyjścia z klawiatury.
#2 DOBRZE
Dlaczego: Modal ogranicza fokus do swojego wnętrza (fokus krąży po elementach okna), ale zapewnia dwa sposoby wyjścia:
- Przycisk zamknięcia (X)
- Klawisz Esc
Po zamknięciu fokus wraca do przycisku otwierającego. Użytkownik ma pełną kontrolę.
#3 DOBRZE
Dlaczego: Pole formularza pokazuje komunikat o błędzie, ale nie blokuje klawisza Tab. Użytkownik może zdecydować, czy chce poprawić błąd teraz, czy wrócić do pola później. Ma swobodę nawigacji.
#4 BŁĄD
Problem: Edytor przechwytuje klawisz Tab: Tab zawsze wstawia wcięcie, Shift + Tab nic nie robi, a Esc nie zmienia trybu.
Dlaczego: Fokus nie może opuścić edytora klawiaturą, a strona nie mówi, jak to zrobić. Kryterium dopuszcza inny sposób wyjścia niż Tab, strzałki czy Esc, ale tylko wtedy, gdy użytkownik zostanie o nim poinformowany.
Naprawa: Daj sposób wyjścia (np. Esc, a potem Tab) i opisz go przy polu, np. „Tabwstawia wcięcie. Aby wyjść z edytora, naciśnij Esc, a potem Tab.”, powiązany z polem przez aria-describedby.
#5 BŁĄD
Problem: Widget przechwytuje klawisz Tab (także Shift + Tab) i nie obsługuje Esc ani strzałek. Fokus zostaje na kontenerze, więc użytkownik nie może ani wyjść, ani dotrzeć do przycisków „Ustawienia” i „Profil”.
Dlaczego: Użytkownik wchodzi do widgetu i nie może z niego wyjść klawiaturą: widget nie obsługuje Esc i nie podaje innego sposobu wyjścia.
Naprawa: Jeśli widget używa własnej nawigacji (np. strzałek), nie blokuj Tab. Dodaj widoczną instrukcję jak wyjść lub obsłuż Esc.
Źródła
- Abou-Zahra S., Eggert E., Vanderheiden G. [i in.] (red.), „2.1.2 No Keyboard Trap Level A”, [w:] Web Content Accessibility Guidelines (WCAG) 2.2 Quick Reference, 2025, https://www.w3.org/WAI/WCAG22/quickref/#no-keyboard-trap [dostęp: 14.05.2026].
- Accessibility Guidelines Working Group Participants, „Understanding SC 2.1.2 No Keyboard Trap (Level A)”, [w:] WCAG 2.2 Understanding Docs, 2025, https://www.w3.org/WAI/WCAG22/Understanding/no-keyboard-trap.html [dostęp: 14.05.2026].
- Accessibility Guidelines Working Group Participants, „Technique F10: Failure of Success Criterion 2.1.2 and Conformance Requirement 5 due to combining multiple content formats in a way that traps users inside one format type”, [w:] Techniques for WCAG 2.2, 2025, https://www.w3.org/WAI/WCAG22/Techniques/failures/F10 [dostęp: 14.05.2026].
- World Wide Web Consortium (W3C), „Kryterium sukcesu 2.1.2 Bez pułapki na klawiaturę”, [w:] Web Content Accessibility Guidelines (WCAG) 2.1, tłum. Fundacja Instytut Rozwoju Regionalnego, 2021, https://www.w3.org/Translations/WCAG21-pl/#bez-pu-apki-na-klawiature [dostęp: 14.05.2026].
- DOCK sp. z o.o., WCAG 2.1.1: Klawiatura, https://wcag.dock.codes/pl/dokumentacja/wcag-212/ [dostęp: 14.05.2026].
- World Wide Web Consortium (W3C), ARIA Authoring Practices Guide (APG), https://www.w3.org/WAI/ARIA/apg/ [dostęp: 14.05.2026].
Dodatkowe linki
- W3C WCAG:
- Dokładna definicja: https://www.w3.org/WAI/WCAG22/quickref/#no-keyboard-trap
- Dokument pomocniczy W3C: https://www.w3.org/WAI/WCAG22/Understanding/no-keyboard-trap.html