3.3.1 Identyfikacja błędu (ang.) Error Identification

Wersja WCAG:

  • 2.2
  • 2.1

Poziom:

  • A

Specjalizacje:

  • Designer
  • Deweloper

Elementy:

  • Formularze

Spis treści

    Istota i cel kryterium

    Kryterium to absolutny fundament dostępności formularzy i wszelkich interaktywnych elementów na stronie internetowej. Wymaga ono, aby każdy automatycznie wykryty błąd w formularzu został natychmiast powiązany z konkretnym komponentem i precyzyjnie wyjaśniony w formie tekstowej. Zadbaj o to, aby mechanizm automatycznie zidentyfikował błąd i dostarczył precyzyjne wskazówki umożliwiające jego natychmiastową naprawę.

    Wdrażając te zasady, zdejmujesz z użytkowników ogromne obciążenie poznawcze i budujesz cyfrowe zaufanie do swojego systemu.

    Pamiętaj: Czysto wizualne sygnały są ulotne i zawodne. Musisz zapewnić jednoznaczny, tekstowy komunikat, który bez przeszkód odczytają również technologie wspomagające.

    Definicja w j. angielskim

    Definicja dostępna pod adresem:
    https://www.w3.org/WAI/WCAG22/quickref/#error-identification

    Definicja w j. polskim

    Definicja dostępna pod adresem:
    https://www.w3.org/Translations/WCAG21-pl/#identyfikacja-b-edu

    Słownik pojęć

    Błędnie wprowadzone dane (ang.) input error
    –

    sytuacja, w której dane dostarczone przez użytkownika są odrzucane przez system ze względu na niespełnienie określonych reguł walidacji.

    Wpływ na dostępność (Kogo wspierasz?)

    • Wszyscy użytkownicy: Czytelne instrukcje drastycznie zmniejszają zmęczenie psychiczne, podnoszą efektywność interakcji i poprawiają ogólne doświadczenie użytkownika niezależnie od stopnia jego sprawności.
    • Osoby z niepełnosprawnościami poznawczymi: Słabo opisany błąd sprawia, że nie są one w stanie zrozumieć, co dokładnie poszło nie tak. Jasne i konkretne komunikaty wskazują im bezpośrednią drogę do znalezienia rozwiązania.
    • Osoby niewidome lub niedowidzące: Osoby korzystające z czytników ekranu potrzebują jednoznacznego, programowego zakodowania błędu, aby ich oprogramowanie mogło go bezbłędnie odczytać. Pamiętaj, że czysto wizualne wyróżnienia, takie jak czerwone ramki, są dla nich całkowicie niewidoczne i bezużyteczne.
    • Osoby z niepełnosprawnością ruchową: Trudności z precyzyjną obsługą klawiatury lub wpisywaniem zwiększają ryzyko pomyłek. Klarowne komunikaty pozwalają im szybko skorygować błąd bez konieczności mozolnego powtarzania całej operacji od początku.

    Zasady wdrażania i wymagania techniczne

    Aby bezkompromisowo zrealizować to kryterium, Twój system musi spełnić trzy fundamentalne wymagania techniczne:

    1. Automatyczna detekcja pomyłki: System musi samodzielnie zidentyfikować nieprawidłowe dane, takie jak błędny format adresu e-mail, puste wymagane pole czy hasło niezgodne z polityką bezpieczeństwa.
    2. Jednoznaczna identyfikacja elementu: Z tekstu (jego treści albo umieszczenia przy polu) musi wynikać, który komponent formularza zawiera błąd. Ramka lub ikona mogą tylko uzupełniać tekst, a powiązanie komunikatu z polem w kodzie (ARIA) to dobra praktyka, nie wymóg 3.3.1.
    3. Tekstowa forma opisu: Komunikat wyjaśniający problem umieść w strukturze tekstu, który zasila drzewo DOM i pozostaje w pełni dostępny dla technologii wspomagających.

    Atrybuty ARIA to dobra praktyka (aria-invalid i aria-describedby – technika ARIA21), a nie wymóg 3.3.1; ogłoszenie komunikatu bez przenoszenia fokusu (np. role="alert") dotyczy kryterium 4.1.3 Komunikaty o statusie. Podczas kodowania możesz zastosować poniższe mechanizmy:

    • Zastosuj atrybut aria-invalid="true" na elemencie polu wprowadzania danych, w którym wykryto błąd, aby natychmiast przekazać czytniku ekranu informację o nieprawidłowym stanie pola i zmienić jego status dostępności.
    • Wykorzystaj atrybut aria-describedby, przypisując mu jako wartość identyfikator (id) kontenera zawierającego tekst błędu. Dzięki temu czytnik automatycznie ogłosi etykietę pola, a zaraz po niej treść komunikatu, gdy użytkownik przeniesie tam fokus.
    • W przypadku dynamicznej walidacji po stronie klienta za pomocą języka JavaScript, dodawaj i usuwaj te atrybuty oraz zawartość tekstową w czasie rzeczywistym. Wykorzystaj do tego zdarzenie blur (opuszczenie pola) lub moment zatwierdzenia formularza.
    • Użyj elementu <span> oznaczonego atrybutem role="alert" lub kontenera z aria-live="polite" do wyświetlania komunikatu. Atrybut role="alert" wymusi na technologii wspomagającej natychmiastowe ogłoszenie błędu w momencie jego dynamicznego wstrzyknięcia do kodu.
    • Wizualne wyróżnienie elementów formularza (np. czerwona ramka, jasnoczerwone tło czy zmiana koloru tekstu) traktuj wyłącznie jako uzupełnienie – nigdy nie wolno Ci polegać tylko na kolorze.

    Wyjątki i sytuacje szczególne

    Kryterium 3.3.1 nie przewiduje żadnych formalnych wyjątków ani łagodzenia reguł na poziomie A.

    Pamiętaj jednak o logicznej granicy jego stosowania: wymagania te dotyczą wyłącznie sytuacji, w których błąd wejściowy jest automatycznie wykrywany przez system.

    Jeżeli mechanizm systemowy nie posiada zaimplementowanej walidacji dla danego pola i przepuści niepoprawne dane bez ich wykrycia, reguła ta technicznie nie ma zastosowania.

    Dobrą praktyką jest jednak dążenie do automatyzacji detekcji wszędzie tam, gdzie format danych jest mierzalny.

    Przykłady implementacji

    Najczęstsze błędy

    • Zbyt szybkie usuwanie komunikatów: Likwidowanie ostrzeżeń z ekranu przed upływem czasu potrzebnego na ich spokojne przeczytanie i zrozumienie przez użytkownika.
    • Sygnalizowanie błędu tylko wizualnie: Pole z błędem dostaje jedynie czerwoną ramkę lub zmienia kolor, a nie pojawia się tekst, który mówi, że wystąpił błąd i na czym polega.
    • Ukrywanie komunikatów w dymkach ((ang.) tooltips): Osadzanie błędów wyłącznie pod najechaniem myszką lub aktywacją pola, co odcina od nawigacji użytkowników mobilnych oraz osoby korzystające wyłącznie z klawiatury.
    • Serwowanie bezużytecznych ogólników: Wdrażanie lakonicznych komunikatów typu „Wystąpił błąd” lub „Niepoprawne dane”, które w żaden sposób nie pomagają w naprawie pomyłki.
    • Ignorowanie pominiętych pól wymaganych: Brak wygenerowania konkretnego komunikatu o błędzie informującego, że puste pole było w rzeczywistości obowiązkowe.

    Najlepsze praktyki

    • Zapewnij precyzyjny kontekst i format: Kiedy oczekujesz konkretnej struktury (np. przy dacie), wprost podaj wymagany wzorzec: „Wprowadź datę w formacie DD-MM-RRRR”.
    • Zarządzaj skupieniem uwagi ((ang.) focus management): Natychmiast po nieudanej próbie wysłania formularza przenieś fokus klawiatury na zbiorcze podsumowanie błędów lub na pierwszy element zawierający pomyłkę.
    • Stosuj walidację hybrydową: Zawsze wykonuj ostateczną walidację po stronie serwera jako nienaruszalne zabezpieczenie, dbając o to, by komunikaty z serwera były programowo dostępne po przeładowaniu strony.
    • Wzmacniaj przekaz ikonami: Oprócz koloru, wykorzystuj czytelne symbole ostrzegawcze (np. wykrzykniki), traktując je jako cenne uzupełnienie tekstu.
    • Buduj zbiorcze podsumowania: W rozbudowanych formularzach umieszczaj na samej górze strony sekcję podsumowującą wszystkie pomyłki wraz z linkami kotwiczącymi do konkretnych pól.
    • Dbaj o bliskość przestrzenną: Tekstowe komunikaty o błędach plasuj zawsze w bezpośrednim sąsiedztwie pola, którego dotyczą, ułatwiając lokalizację wizualną i programową.
    • Buduj zaufanie użytkowników: Pamiętaj, że przejrzysta identyfikacja błędów drastycznie zmniejsza frustrację i pozwala na płynną realizację celów wszystkim odbiorcom.

    Metody testowania

    • Narzędzie deweloperskie (ang.) Developer Tools: Przeanalizuj strukturę drzewa DOM i drobiazgowo zweryfikuj, czy wadliwe pole wejściowe dynamicznie otrzymuje atrybut aria-invalid="true" oraz czy jego aria-describedby bezbłędnie odpowiada identyfikatorowi kontenera z tekstem błędu. Te atrybuty to dobra praktyka (technika ARIA21), ale nie wymóg kryterium 3.3.1 – wymagany jest tekst, który wskazuje pole i opisuje błąd.
    • NVDA: Uruchom czytnik ekranu i zweryfikuj, czy po przejściu klawiaturą do zidentyfikowanego pola otrzymujesz pełny komunikat o błędzie bez patrzenia na monitor oraz czy funkcja role="alert" wymusza natychmiastowe ogłoszenie pomyłki. Odczyt komunikatu przy polu to dobra praktyka, a ogłoszenie komunikatu bez przenoszenia fokusu dotyczy kryterium 4.1.3 Komunikaty o statusie – żadne z nich nie jest wymogiem 3.3.1. Wymagany jest tekst, który wskazuje pole i opisuje błąd.
    • ANDI.JS: Aktywuj ten moduł testowy, aby precyzyjnie sprawdzić, co „widzi” technologia asystująca – narzędzie podświetli elementy formularza i wyświetli tekst zastępczy oraz przypisane opisy błędów, ułatwiając weryfikację kontekstu.

    Sprawdź swoją wiedzę

    W linku poniżej znajduje się 6 formularzy. Zostały one celowo zaprogramowane tak, aby po kliknięciu przycisku „Wyślij” wygenerować błąd walidacji. Twoim zadaniem jest sprawdzenie, czy strona wskazuje pole z błędem i opisuje błąd tekstem.

    Jak to sprawdzić?

    1. Kliknij przycisk „Wyślij” w każdym przykładzie, aby wywołać błąd.
    2.  Sprawdź, czy pojawił się tekst opisujący błąd – sama zmiana koloru lub ramki pola nie wystarczy.
    3. Sprawdź, czy z tekstu wiadomo, którego pola dotyczy błąd.
    4. Sprawdź, czy tekst mówi, na czym polega błąd (np. zły format, za mało cyfr), a nie tylko ogólnikowo stwierdza, że wystąpił. Podpowiedź, jak poprawić błąd, to już wymóg kryterium 3.3.3.
    5. Dodatkowo (dobra praktyka): w narzędziach deweloperskich (Zbadaj element) sprawdź, czy pole ma aria-invalid="true" i czy komunikat jest powiązany z polem przez aria-describedby. Brak tych atrybutów ani to, że czytnik ekranu nie ogłosi komunikatu, nie narusza kryterium 3.3.1 (może naruszać inne kryteria, np. 4.1.3 Komunikaty o statusie).

    Proponowane narzędzia: Klawiatura (Tab, Shift + Tab, Spacja, Enter ), Myszka, Narzędzie deweloperskie (ang.) Developer Tools, NVDA

    Notatka: Zanim zajrzysz do rozwiązania, przetestuj i zapisz swoje wnioski na kartce.

    #1 DOBRZE

    Dlaczego: Tekst „PESEL musi składać się z 11 cyfr.” wskazuje pole i opisuje, na czym polega błąd – tego wymaga kryterium 3.3.1. Dodatkowo pole ma aria-invalid="true" i aria-describedby="tc1-error", a komunikat role="alert", więc czytnik ekranu ogłosi błąd i odczyta go przy polu. To dobra praktyka (a role="alert" spełnia też kryterium 4.1.3).


    #2 DOBRZE

    Dlaczego: Komunikat błędu jest niezwykle precyzyjny. Nie tylko informuje o błędzie, ale podaje oczekiwany wzorzec (DD-MM-RRRR) oraz konkretny przykład (15-05-2026). Pole jest poprawnie powiązane atrybutami ARIA.


    #3 BŁĄD

    Problem: Po kliknięciu „Wyślij” pole otrzymuje jedynie czerwoną ramkę. Nie pojawia się żaden tekst, który mówiłby, że wystąpił błąd i na czym polega.
    Dlaczego: Kryterium 3.3.1 wymaga opisania błędu tekstem. Ramki nie odczyta czytnik ekranu, a osoby słabowidzące lub z zaburzeniami rozpoznawania barw mogą jej nie zauważyć.
    Naprawa: Dodaj przy polu tekst błędu, np. „Adres e-mail musi zawierać znak @.”. Dobrą praktyką jest też powiązanie komunikatu z polem (aria-describedby) i ustawienie aria-invalid="true".


    #4 DOBRZE

    Dlaczego: Pod polem pojawia się tekst „Zbyt krótki numer.”, który wskazuje pole i opisuje błąd – to wystarcza do spełnienia kryterium 3.3.1. Atrybuty aria-invalid i aria-describedby nie są wymogiem tego kryterium, ale warto je dodać.
    Uwaga: Komunikat nie ma role="alert" ani aria-live, więc czytnik ekranu nie ogłosi go po kliknięciu „Wyślij”. To naruszenie kryterium 4.1.3 Komunikaty o statusie, nie 3.3.1.


    #5 BŁĄD

    Problem: Mimo zastosowania poprawnych atrybutów ARIA, treść komunikatu to lakoniczne „Błąd.”.
    Dlaczego: Kryterium 3.3.1 wymaga opisania tekstem, na czym polega błąd. Samo „Błąd.” nie mówi, co jest nie tak (np. że data ma zły format). Podpowiedź, jak go poprawić, to już wymóg kryterium 3.3.3.
    Naprawa: Opisz błąd, np. „Data urodzenia ma niepoprawny format.”. Jeśli dodasz wskazówkę („Wpisz ją w formacie DD-MM-RRRR, np. 15-05-1990.”), komunikat spełni też kryterium 3.3.3.


    #6 BŁĄD

    Problem: Formularz ma dwa pola „Kod pocztowy”. Po kliknięciu „Wyślij” nad nimi pojawia się komunikat „Kod pocztowy ma niepoprawny format.”, a błędne pole wyróżnia tylko czerwona ramka.
    Dlaczego: Komunikat opisuje błąd, ale z tekstu nie wynika, którego z dwóch pól dotyczy. Kryterium 3.3.1 wymaga, aby tekst wskazywał także pole z błędem – czerwonej ramki nie odczyta czytnik ekranu i nie każdy ją zauważy.
    Naprawa: Wskaż pole w treści komunikatu, np. „Kod pocztowy w adresie do korespondencji ma niepoprawny format.”, albo umieść komunikat bezpośrednio przy tym polu i powiąż go z nim (aria-describedby).

    Źródła