wcag
Jak dostosować witrynę do WCAG 2.2
Praktyczny, przyjazny dla programistów przewodnik po zgodności z WCAG 2.2 — od skanowania z axe-core po audyty manualne i ciągłe monitorowanie.
Dostosowanie witryny do WCAG 2.2 to proces, a nie jednorazowa poprawka. Zgodność jest wynikiem powtarzalnego przepływu pracy: zrozumienia standardu, zmierzenia stanu wyjściowego, naprawienia właściwych rzeczy we właściwej kolejności, walidacji z prawdziwą technologią asystującą i prawdziwymi użytkownikami, udokumentowania wyniku oraz niedopuszczenia do jego regresu. Ten przewodnik zamienia ten przepływ pracy w konkretną, krok po kroku mapę drogową, którą Twój zespół może zacząć stosować już dziś — bez uciekania się do „nakładek” (overlay) dostępności, które maskują problemy w DOM zamiast je naprawiać i były wielokrotnie wymieniane w pozwach sądowych.
Krok 1: Zrozum, czego naprawdę wymaga WCAG 2.2
Zanim cokolwiek zaudytujesz, wyjaśnij sobie cel. Wytyczne dotyczące dostępności treści internetowych są zorganizowane wokół czterech zasad, podsumowanych akronimem POUR:
- Perceivable (Postrzegalne) — użytkownicy muszą móc postrzegać treść. Pomyśl o alternatywach tekstowych dla obrazów, napisach i transkrypcjach dla mediów oraz o wystarczającym kontraście kolorów.
- Operable (Funkcjonalne) — każda funkcja musi działać bez myszy. Pełna obsługa za pomocą klawiatury, widoczne wskaźniki fokusu oraz brak pułapek klawiaturowych to podstawowe wymagania.
- Understandable (Zrozumiałe) — treść i zachowanie muszą być przewidywalne. Tutaj mieszczą się czytelne etykiety, spójna nawigacja, pomocne komunikaty o błędach i czytelny język.
- Robust (Solidne) — kod musi być możliwy do przetworzenia przez obecną i przyszłą technologię asystującą, co w praktyce oznacza prawidłowy HTML i poprawne użycie nazw, ról i wartości ARIA.
Każda zasada dzieli się na sprawdzalne kryteria sukcesu, a każdemu kryterium przypisany jest poziom zgodności: A (podstawowy), AA (prawna i praktyczna baza, do której dąży większość organizacji) oraz AAA (rozszerzony). Gdy ktoś mówi „WCAG 2.2 AA”, ma na myśli zgodność z każdym kryterium sukcesu poziomu A i poziomu AA. WCAG 2.2 dodaje dziewięć nowych kryteriów względem 2.1 — w tym Fokus nieprzesłonięty, Ruchy przeciągania, Rozmiar celu (minimalny) oraz Dostępne uwierzytelnianie — z których większość poprawia doświadczenie użytkowników korzystających z klawiatury, słabowidzących i z ograniczeniami ruchowymi.
Warto wiedzieć, dlaczego to właśnie ten cel. Zgodność AA jest przywoływana przez przepisy prawa i regulacje, które najprawdopodobniej Cię dotyczą: zapoznaj się ze zgodnością z WCAG jako standardem technicznym, a następnie zobacz, jak odnosi się ona do European Accessibility Act, ADA dla prywatnych i publicznych podmiotów w USA oraz Section 508 dla amerykańskich agencji federalnych i ich dostawców. Jeśli po drodze potknie Cię terminologia, trzymaj nasz słownik dostępności otwarty w karcie.
Jeszcze dwie koncepcje kształtują każde uczciwe oświadczenie o zgodności. Pierwsza to zakres zgodności: zgodność z WCAG dotyczy pełnych stron, a nie izolowanych komponentów, oraz kompletnych procesów (np. całego procesu zakupowego) — nie możesz twierdzić, że strona jest zgodna, jeśli jeden krok wieloetapowego zadania zawodzi. Druga to technologia wspierana przez ułatwienia dostępu: możesz polegać wyłącznie na takich sposobach korzystania z funkcji, które są faktycznie obsługiwane przez technologię asystującą, z której korzystają Twoi użytkownicy. W praktyce oznacza to testowanie z aktualnymi czytnikami ekranu i przeglądarkami zamiast zakładania, że sam prawidłowy kod gwarantuje użyteczny rezultat. Miej oba na uwadze, ustalając zakres swojej pracy w kolejnych krokach; to one decydują, co możesz w sposób uzasadniony uznać za osiągnięte.
Krok 2: Wykonaj automatyczne skanowanie bazowe
Nie naprawisz tego, czego nie mierzysz, więc ustal punkt wyjścia. Testy automatyczne są szybkie, powtarzalne i doskonałe w wychwytywaniu masowych, mechanicznych usterek, które trapią większość witryn: brakujących tekstów alternatywnych, niskiego kontrastu kolorów, pustych linków i przycisków, nieoznaczonych pól formularzy, brakującego języka dokumentu oraz zduplikowanych ID.
Narzędzia oparte na silniku open source axe-core — w tym oprogramowanie do skanowania dostępności firmy QualiBooth — w kilka minut tworzą listę problemów uporządkowaną według priorytetów. Jeśli chcesz tylko szybko ocenić, na jakim etapie jesteś, zacznij od bezpłatnego skanowania dostępności kilku kluczowych stron.
Kilka zasad, aby utrzymać uczciwość Twojej linii bazowej:
- Skanuj reprezentatywne szablony, a nie całą witrynę. Przetestuj stronę główną, szablon treści/artykułu, stronę produktu lub kategorii, formularz (rejestracja, zakup, kontakt) oraz każdy panel po zalogowaniu. Naprawienie jednego szablonu zwykle naprawia setki stron.
- Testuj rzeczywiste stany, a nie tylko początkowe ładowanie. Otwieraj menu, rozwijaj akordeony, wywołuj okna modalne i wysyłaj formularze z błędami. Wiele naruszeń pojawia się dopiero w stanach interaktywnych.
- Zapisuj liczby. Zanotuj liczbę problemów według wagi i według kryterium sukcesu. To Twój punkt odniesienia przed/po oraz podstawa zaległości w naprawach.
Bądź uczciwy co do pułapu: narzędzia automatyczne niezawodnie wykrywają tylko 30–40% problemów WCAG. Czyste skanowanie automatyczne jest konieczne, ale nigdy nie jest wystarczające dla rzeczywistego oświadczenia o zgodności.
Krok 3: Uzupełnij automatyzację audytem manualnym
Pozostałe 60–70% kryteriów WCAG wymaga ludzkiej oceny. Czy ten tekst alternatywny rzeczywiście przekazuje znaczenie obrazu, czy tylko opisuje piksele? Czy kolejność odczytu i fokusu jest logiczna? Czy komunikaty o błędach mówią użytkownikowi, jak naprawić sytuację? Czy niestandardowa lista rozwijana jest poprawnie ogłaszana i czy możesz do niej dotrzeć oraz ją obsłużyć wyłącznie za pomocą klawiatury? Żaden silnik nie odpowie na to wiarygodnie.
Ustrukturyzowany audyt manualny zazwyczaj obejmuje:
- Obsługę wyłącznie klawiaturą — przejdź tabulatorem przez każdy element interaktywny; potwierdź widoczny wskaźnik fokusu, logiczną kolejność, brak pułapek oraz to, że wszystko, co możesz zrobić myszą, możesz zrobić bez niej.
- Strukturę semantyczną — nagłówki w sensownej hierarchii, punkty orientacyjne (landmarks), listy oznaczone jako listy, tabele z prawidłowymi nagłówkami.
- Formularze — etykiety programowe, pogrupowane pola, czytelne oznaczenie pól wymaganych oraz komunikaty o błędach powiązane z polami, które opisują.
- Treści dynamiczne — okna modalne, które prawidłowo przechwytują i przywracają fokus, regiony aktywne (live regions) ogłaszające aktualizacje oraz ARIA stosowane tylko tam, gdzie natywny HTML nie wykona zadania.
- Jakość treści — sensowny tekst linków, wystarczający kontrast w rzeczywistych kontekstach oraz treści, które nie opierają się wyłącznie na kolorze lub kształcie.
Nasz przewodnik po manualnych audytach dostępności przeprowadza przez pełną metodologię, a częste problemy z dostępnością, których należy unikać to szybka lista kontrolna usterek, które audytorzy znajdują najczęściej. Jeśli wolisz, by zrobiono to za Ciebie, zespół konsultingu w zakresie dostępności firmy QualiBooth przeprowadza eksperckie audyty manualne względem kryteriów WCAG 2.2 AA.
Krok 4: Ustal priorytety i napraw
Długa lista naruszeń przytłacza, dopóki nie ustawisz jej w kolejności. Przeprowadź triaż, łącząc wpływ na użytkownika i zasięg:
- Najpierw blokery. Wszystko, co uniemożliwia wykonanie zadania jakiejś grupie użytkowników — pułapki klawiaturowe, niedostępny proces zakupu, nieoznaczony formularz logowania — trafia na samą górę, niezależnie od tego, ile wystąpień istnieje.
- Następnie problemy o dużej częstotliwości, obejmujące całą witrynę. Problem z kontrastem lub fokusem w nagłówku, stopce lub komponencie systemu projektowego mnoży się na każdej stronie. Naprawienie go raz daje największy zwrot.
- Następnie problemy specyficzne dla strony i treści. Pojedynczy brakujący tekst alternatywny, pojedyncza źle oznaczona kontrolka lub jednorazowa luka w nagłówkach.
Naprawiając, naprawiaj źródło, a nie objaw. Preferuj natywne elementy HTML zamiast łatanych ARIA <div>-ów; popraw komponent systemu projektowego, a nie każdą stronę, która go używa; i zajmij się przyczynami źródłowymi w szablonach oraz wspólnych komponentach, aby poprawka skalowała się. Skanuj ponownie po każdej partii, abyś widział, jak liczby spadają, i unikał wprowadzania regresji. To także właściwy moment, by wbudować dostępność w swoje tokeny projektowe (design tokens) — ustaw jako domyślne kolory bezpieczne pod względem kontrastu, minimalny rozmiar celu 24×24 px oraz widoczne style fokusu, aby nowa praca powstawała od razu zgodna.
Kilka wzorców naprawczych powtarza się na tyle często, by wymienić je wprost:
- Korzystaj z platformy. Natywne
<button>,<a href>,<input>,<select>i<dialog>zapewniają za darmo obsługę klawiatury, zarządzanie fokusem oraz poprawną nazwę dostępną. Po ARIA sięgaj tylko, by wypełnić rzeczywiste luki — i pamiętaj o pierwszej zasadzie ARIA: nie używaj ARIA, jeśli wystarczy element natywny. - Nadawaj nazwy programowo. Każda kontrolka potrzebuje nazwy dostępnej z
<label>,aria-labellubaria-labelledby— a nie tylko pobliskiego tekstu wizualnego. Przyciski wyłącznie z ikoną to najczęstszy winowajca. - Zarządzaj fokusem świadomie. Gdy okno modalne się otwiera, przenieś do niego fokus, uwięź go, gdy jest otwarte, i zwróć go elementowi wyzwalającemu po zamknięciu. Gdy treść aktualizuje się bez nawigacji, użyj regionu aktywnego, aby użytkownicy czytników ekranu usłyszeli, co się zmieniło.
- Nie koduj znaczenia wyłącznie kolorem ani kształtem. Łącz kolor z tekstem, ikonami lub wzorami, aby informacja przetrwała dla użytkowników z daltonizmem i słabowidzących.
Śledź naprawy w swoim zwykłym narzędziu do śledzenia zgłoszeń, oznaczone według kryterium sukcesu, aby praca nad dostępnością była widoczna obok wszystkiego innego, zamiast żyć w osobnym arkuszu, który się dezaktualizuje.
Krok 5: Testuj z technologią asystującą i osobami z niepełnosprawnościami
Zgodność ostatecznie sprowadza się do tego, czy prawdziwi ludzie mogą korzystać z Twojej witryny. Liczą się tu dwie warstwy walidacji i nie są one wymienne.
Testy z czytnikiem ekranu. Zweryfikuj swoje poprawki względem technologii asystującej, której ludzie naprawdę używają: NVDA lub JAWS z Chrome/Firefox w systemie Windows oraz VoiceOver z Safari w macOS i iOS. Wsłuchuj się w trafne nazwy, poprawne role, ogłaszane zmiany stanu oraz sensowną kolejność odczytu. Ewaluacja z czytnikiem ekranu zapewni Ci profesjonalne przejście przez główne kombinacje, jeśli Twojemu zespołowi brakuje doświadczenia.
Testy użyteczności z użytkownikami z niepełnosprawnościami. Spełnienie każdego kryterium sukcesu to podłoga, a nie sufit — witryna może być technicznie zgodna, a mimo to frustrująca w użyciu. Najbardziej wiarygodny sygnał pochodzi z audytów przeprowadzanych przez osoby z niepełnosprawnościami, które testują z własną technologią asystującą i nawykami oraz ujawniają bariery pomijane przez listy kontrolne. To różnica między spełnieniem litery standardu a dostarczeniem prawdziwej dostępności cyfrowej.
Krok 6: Udokumentuj zgodność (oświadczenie i VPAT/ACR)
Gdy już naprawisz i zwalidujesz, utrwal wynik. Dokumentacja to to, co zamienia „próbowaliśmy” w możliwe do obrony, komunikowalne oświadczenie.
- Oświadczenie o dostępności. Publiczna strona, która podaje Twój cel zgodności (np. WCAG 2.2 AA), opisuje, co zrobiłeś, wymienia wszelkie znane ograniczenia i daje użytkownikom sposób zgłaszania problemów. Wiele regulacji, w tym EAA, oczekuje takiej strony.
- VPAT / Accessibility Conformance Report. Wypełniony Voluntary Product Accessibility Template staje się ACR — standardowym artefaktem, którego zespoły zakupowe i nabywcy korporacyjni żądają jako dowodu. Nasz przewodnik czym jest VPAT/ACR wyjaśnia ten dokument, a usługa raporty VPAT tworzy dokładny, poparty audytem raport, który możesz przekazać klientom i zespołom prawnym.
Pisz je w oparciu o dowody z rzeczywistych wyników audytu, a nie aspiracje. VPAT, który zawyża zgodność, to obciążenie, a nie atut.
Krok 7: Utrzymuj zgodność w czasie
Dostępność ulega regresji w chwili, gdy witryna się zmienia — nowy komponent, przeprojektowany formularz, widget firmy trzeciej lub edycja treści mogą po cichu ponownie wprowadzić bariery. Zgodność to stan, który utrzymujesz, a nie kamień milowy, który zaliczasz raz.
Wbuduj dostępność w cykl życia oprogramowania:
- Shift left. Dodaj do swojego potoku automatyczne sprawdzenia za pomocą integracji dostępności z CI/CD, aby naruszenia były wychwytywane przy pull requestach, zanim trafią na produkcję — w najtańszym możliwym miejscu na ich naprawę.
- Monitoruj produkcję. Zaplanuj cykliczne audyty dostępności, aby wychwytywać regresje i dryf treści, których kontrole przedwydaniowe nie zobaczą.
- Wzmocnij swój zespół. Wyposaż projektantów, programistów i autorów treści w zestaw narzędzi dostępności oraz wspólne standardy, aby dostępność była domyślnym podejściem każdego, a nie późniejszą myślą specjalisty.
- Zarządzaj na dużą skalę. W przypadku dużych lub wielowitrynowych organizacji platforma taka jak Agora centralizuje śledzenie, raportowanie i naprawy w różnych zespołach.
Błędy, które wykolejają wysiłki na rzecz zgodności
Zespoły, które grzęzną, zwykle robią to z przewidywalnych powodów. Uważaj na te:
- Zaufanie wyłącznie automatyzacji. Zielony raport automatyczny pokrywa tylko jedną trzecią kryteriów. Traktowanie go jako dowodu zgodności to najczęstszy — i najbardziej ryzykowny prawnie — błąd.
- Kupowanie nakładki. Nakładki i „widgety dostępności” obiecują natychmiastową zgodność, wstrzykując JavaScript, który nadpisuje stronę. Nie naprawiają one bazowego kodu, często kolidują z własną technologią asystującą użytkowników i były wymieniane w rosnącej liczbie skarg. To skrót do ryzyka, a nie do zgodności.
- Naprawianie stron zamiast systemów. Naprawianie pojedynczych stron przy pozostawieniu zepsutego systemu projektowego oznacza, że każda nowa strona ponownie wprowadza te same usterki. Najpierw napraw wspólne komponenty i szablony.
- Traktowanie tego jak projektu jednorazowego. Bez kontroli CI/CD i cyklicznych audytów zgodna witryna oddala się od zgodności w ciągu kilku cykli wydawniczych.
- Pomijanie prawdziwych użytkowników. Zgodność techniczna bez testów użyteczności może mimo wszystko pozostawić użytkowników z niepełnosprawnościami niezdolnych do wykonania kluczowych zadań.
Unikanie tych błędów chroni Twoją inwestycję przed wyciekaniem w chwili, gdy projekt „trafia na produkcję”.
Wszystko razem
Realistyczna droga do WCAG 2.2 AA wygląda tak: poznaj zasady POUR i cel AA, wykonaj automatyczne skanowanie bazowe, nałóż na nie audyt manualny, naprawiaj według wpływu i zasięgu, waliduj z czytnikami ekranu i użytkownikami z niepełnosprawnościami, udokumentuj swoją zgodność w oświadczeniu i VPAT, a następnie utrzymuj ją w zdrowiu dzięki kontrolom CI/CD i cyklicznym audytom. Każdy krok wzmacnia poprzedni — i żaden z nich nie zależy od nakładki, która zamalowuje prawdziwy kod.
Zacznij od małych kroków i buduj rozpęd: zeskanuj w tym tygodniu kilka szablonów, popraw style kontrastu i fokusu w swoim systemie projektowym oraz umieść jedną automatyczną kontrolę w swoim potoku. Stamtąd powyższa mapa drogowa poprowadzi Cię przez resztę drogi. Gdy będziesz gotów, by przyspieszyć, zapoznaj się z naszym cennikiem, poproś o demo lub porozmawiaj z ekspertem o planie naprawczym dostosowanym do Twojego stosu technologicznego.
Gotowy, by osiągnąć WCAG 2.2 AA — i to utrzymać?