2.1.2 Brak pułapki na klawiaturę (ang.) No Keyboard Trap

Wersja WCAG:

  • 2.2
  • 2.1

Poziom:

  • A

Specjalizacje:

  • Deweloper

Elementy:

  • Dialogi i warstwy
  • Multimedia
  • Przyciski i kontrolki

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ć?

    1. Użyj klawisza Tab, aby przejść do elementu.
    2. Aktywuj element (przycisk, pole formularza).
    3. Spróbuj wyjść, używając Tab, Shift + Tab, strzałek lub Esc.
    4. 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.
    5. 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