Audyt WCAG: audyt dostępności i poprawki w kodzie

Europejski akt o dostępności obowiązuje od 28 czerwca 2025 r. Audytujemy strony i aplikacje mobilne według WCAG 2.2 AA i poprawiamy w kodzie to, co nie spełnia wymagań. Na naszej stronie axe znalazł 6 naruszeń, a pomiar piksel po pikselu 29 elementów tekstu na zdjęciach ze zbyt słabym kontrastem.

Design team reviewing a UI on screen (Unsplash)

Dlaczego z nami: audyt dostępności i wdrożenie poprawek w jednym zespole

W Centrum Komunikacji, aplikacji do komunikacji dla osób głuchych i niewidomych, VoiceOver mógł przejść z okna dialogowego z 4 kontrolkami na 25 kontrolek ukrytych za nim. Naprawiliśmy to w kodzie komponentu React Native. Tak wygląda u nas praca nad dostępnością: projektanci, frontend developerzy i QA, którzy audytują Twój produkt, potem sami zmieniają komponenty w React, React Native albo Django.

Testujemy strony internetowe i natywne aplikacje mobilne. Na iOS i Androidzie czytnik ekranu korzysta z natywnych widoków, więc poprawka często trafia do komponentu React Native, a nie do HTML-a.

Raport z listą błędów to dopiero początek, bo ktoś jeszcze musi je naprawić. Czym jest audyt i co zawiera raport, wyjaśniamy w haśle słownika audyt dostępności.

W październiku 2026 r. przeprowadziliśmy audyt naszej strony według WCAG 2.2 AA i wdrożyliśmy poprawki. Strona jest nadal częściowo zgodna, między innymi dlatego, że 7 z 10 naszych filmów na YouTube ma tylko automatyczne napisy.

Developer working at an ultrawide monitor with code editor in a dark office

Kto potrzebuje audytu WCAG

Audyt WCAG zamawiają zwykle firmy objęte Europejskim aktem o dostępności, podmioty publiczne, wykonawcy w przetargach publicznych i zespoły produktowe, które muszą wykazać, że ich strona lub aplikacja spełnia WCAG. Te wymagania wynikają z przepisów:

  • Europejski akt o dostępności, dyrektywa (UE) 2019/882, od 28 czerwca 2025 r. obejmuje wybrane produkty i usługi cyfrowe, m.in. bankowość, e-commerce i e-booki.
  • W Polsce dyrektywę wdraża ustawa z 26 kwietnia 2024 r. o zapewnianiu spełniania wymagań dostępności niektórych produktów i usług przez podmioty gospodarcze (Dz.U. 2024 poz. 731).
  • Podmioty publiczne obowiązuje ustawa z 4 kwietnia 2019 r. o dostępności cyfrowej stron internetowych i aplikacji mobilnych podmiotów publicznych (tekst jednolity Dz.U. 2023 poz. 1440). Wymaga ona dostępnych stron i aplikacji oraz opublikowanej deklaracji dostępności.
  • Art. 100 Prawa zamówień publicznych wymaga, żeby opis przedmiotu zamówienia (OPZ) uwzględniał wymagania dostępności dla osób z niepełnosprawnościami, gdy z systemu będą korzystać ludzie. Dlatego WCAG trafia do OPZ i umów.

Czy Europejski akt o dostępności (EAA) obejmuje Twoją usługę, oceni prawnik. My sprawdzimy produkt pod kątem WCAG i poprawimy to, co nie spełnia wymagań.

Co obejmuje nasz audyt zgodności z WCAG

Wszystkie 55 kryteriów sukcesu, jedno po drugim

Raport zawiera tabelę wszystkich 55 kryteriów sukcesu WCAG 2.2 na poziomach A i AA. Każde ma status: spełnia, spełnia częściowo, nie spełnia, nie dotyczy albo wymaga oceny człowieka.

Próbka ustalona na starcie

Przed testami ustalamy próbkę: strony i ekrany według szablonów, całe procesy, takie jak rejestracja, formularze i płatność, każdą wersję językową, komputer i telefon. W audycie naszej strony było to 48 adresów EN i PL, testowanych w rozdzielczości 1440x900 i 390x844.

Testy automatyczne

Uruchamiamy axe-core w Playwright z tagami WCAG 2.0, 2.1 i 2.2 dla poziomów A i AA na każdej stronie z próbki. Skaner szybko wyłapuje brakujące nazwy, etykiety i błędy struktury, ale sprawdza tylko część kryteriów.

Testy ręczne i skrypty tam, gdzie skaner nie patrzy

Kontrast tekstu na zdjęciach i gradientach mierzymy piksel po pikselu. Sprawdzamy dopasowanie treści do szerokości 320 px, powiększenie 200% i odstępy tekstu (kryterium 1.4.12). Przechodzimy każdą stronę samą klawiaturą, klawiszami Tab i Shift+Tab przez menu, okna dialogowe i formularze, a do tego sprawdzamy animacje i ruch, prefers-reduced-motion i napisy w filmach.

Czytniki ekranu osobno na każdej platformie

VoiceOver na iOS, TalkBack na Androidzie i czytnik ekranu w przeglądarce, każdy w osobnej rundzie, bo strony i aplikacje mobilne psują się w inny sposób.

Raport, z którym zespół może od razu pracować

Przy każdym problemie: kryterium sukcesu, miejsce, kroki odtworzenia, oczekiwany wynik i priorytet, gotowe do przeniesienia do backlogu. Webowa runda testów z czytnikiem ekranu w aplikacji Generator ETR dla PSONI zakończyła się listą 16 ponumerowanych uwag z nagraniami.

Retest, zanim cokolwiek zamkniemy

Każdą poprawkę testujemy ponownie na stagingu i zamykamy znalezisko dopiero wtedy, gdy poprawka przejdzie test.
User journey mapping with sticky notes (Unsplash)

Wdrożenie poprawek dostępności w Twoim kodzie

Wdrożenie poprawek dostępności to zmiany w komponentach, etykietach, komunikatach i stylach, aż każde kryterium, które nie przeszło testu, zostanie spełnione. Oto poprawki z projektów naszych klientów:

  • W aplikacji Centrum Komunikacji VoiceOver mógł przejść z okna dialogowego z 4 własnymi kontrolkami na 25 kontrolek ukrytych za nim. Przyczyną była właściwość accessibilityViewIsModal w React Native, która nie docierała do natywnego widoku. Zmieniliśmy styl prezentacji na fullScreen i usunęliśmy martwą właściwość z 3 komponentów (sierpień 2026). To problem z zarządzaniem fokusem, którego skaner stron nie zobaczy.
  • Dla PSONI prowadzimy arkusz wszystkich etykiet ARIA w aplikacji webowej i mobilnej. Ten sam arkusz służy jako katalog komunikatów błędów i statusów.
  • Aplikacja PSONI ma 3 rozmiary czcionki: 100%, 150% i 200%, co pokrywa powiększenie 200% z kryterium 1.4.4. Użytkownik wybiera też głos męski lub żeński i tempo czytania w module zamiany tekstu na mowę.
  • Poprawiliśmy kontrast elementów, takich jak podkreślenie czytanego na głos słowa w module zamiany tekstu na mowę, i zrobiliśmy retest na stagingu.
  • Gdy tekst przekraczał limit znaków, przycisk po prostu szarzał, bez żadnego wyjaśnienia. Dodaliśmy komunikat walidacji, a retest we wrześniu 2026 r. wypadł pomyślnie.

Dostępność zaczyna się też przed kodem. Specyfikacja PSONI wymaga widocznej etykiety tekstowej przy każdej ikonie, zgodnie z kryterium WCAG 1.1.1 i wytycznymi W3C dla osób z trudnościami poznawczymi. Takie wymaganie trzeba spełnić w projekcie interfejsu, zanim powstanie kod. To zadanie dla projektowania UX.

Testy dostępności w działających projektach

Testujemy dostępność w projektach dla ludzi, którzy na co dzień jej potrzebują.

Centrum Komunikacji: WCAG 2.1 AA, czytniki ekranu i monitory brajlowskie

Centrum Komunikacji to aplikacja mobilna i webowa dla osób głuchych, słabosłyszących, niewidomych i głuchoniewidomych. Wymaganiem była zgodność z WCAG 2.1 AA oraz z czytnikami ekranu i monitorami brajlowskimi. Testujemy z czytnikami ekranu przez cały projekt, od listopada 2025 r., a raport WCAG nasz zespół przygotował do odbioru etapu 2, zakończonego 27 kwietnia 2026 r.

We wrześniu 2026 r. niewidomy ekspert dostępności, który współpracuje z klientem, przetestował produkcyjną aplikację na iOS i Androidzie. Na kafelkach usług czytnik odczytywał tylko wspólny tekst przycisku, więc użytkownik nie mógł ich odróżnić. Zmieniliśmy etykiety i zrobiliśmy retest na obu platformach.

PSONI: Generator ETR według WCAG 2.2 AAA

Dla PSONI (Polskiego Stowarzyszenia na rzecz Osób z Niepełnosprawnością Intelektualną) budujemy Generator ETR, aplikację webową i mobilną, która przekształca dokumenty w tekst łatwy do czytania. Specyfikacja wymaga WCAG 2.2 na poziomie AAA.

Webowa runda testów z czytnikiem ekranu zakończyła się 6 października 2026 r., a jej wyniki trafiły do osobnego zadania z poprawkami. Runda mobilna z TalkBack i VoiceOver trwała w październiku 2026 r. Testy z czytnikiem wykryły komunikaty błędów, których czytnik nie odczytywał, licznik ponownego wysłania kodu odczytywany co 5 sekund i fokus przeskakujący na przycisk zamknięcia zamiast na treść dokumentu.

Kto prowadzi prace

Daria Gusieva jest Head of Design w Order Group od marca 2026 r. Prowadzi UX, UI i dostępność według WCAG w projektach klientów, a w naszym słowniku recenzuje hasła o WCAG 2.2, audycie dostępności, testach z czytnikiem ekranu i zarządzaniu fokusem.

UX design thinking workshop - empathize, ideate, test (Unsplash)

Jak przebiega nasz audyt dostępności

Zakres i standard

Ustalamy standard, wersję i poziom (np. WCAG 2.2 AA), platformy oraz próbkę ekranów i procesów.

Testy automatyczne i ręczne

Skaner, testy ręczne, test klawiatury i czytniki ekranu na każdej platformie z zakresu.

Raport

Tabela kryteriów ze statusami i lista problemów z priorytetami, nagraniami i krokami odtworzenia.

Poprawki w projekcie i w kodzie

Poprawki robi ten sam zespół: projektanci, frontend developerzy i QA.

Retest i deklaracja dostępności

Każde znalezisko testujemy ponownie i przygotowujemy materiał do Twojej deklaracji dostępności.

Co znaleźliśmy w audycie naszej strony

10 października 2026 r. przeprowadziliśmy audyt ordergroup.co według WCAG 2.2 AA: 48 adresów EN i PL, 55 kryteriów, axe-core i testy ręczne.

Przed poprawkami skaner axe znalazł 6 naruszeń. Testy ręczne i skrypty wykryły problemy, których axe nie sprawdza: pomiar kontrastu piksel po pikselu wykazał 29 elementów tekstu na zdjęciach z kontrastem poniżej progu na 10 stronach, test odstępów tekstu 5 miejsc z uciętym tekstem, a test klawiatury 2 komponenty z niewidocznym fokusem.

Naprawiliśmy te problemy w kodzie i wdrożyliśmy poprawki na produkcji. Skaner axe nie zgłasza teraz żadnych naruszeń, a spośród 2140 zmierzonych elementów tekstu na zdjęciach żaden nie ma kontrastu poniżej progu.

Mimo to nasz wynik to nadal częściowa zgodność. Tylko automatyczne napisy ma 7 z 10 naszych filmów na YouTube (kryterium 1.2.2), a test z czytnikiem ekranu i ocena audiodeskrypcji wciąż przed nami. Napisy to treść, nie kod: na naszej stronie musimy je dodać sami, a na stronie klienta robi to właściciel treści.

Code on screen (Unsplash)

Skaner a testy ręczne na ordergroup.co

Co skaner axe i testy ręczne znalazły na ordergroup.co przed poprawkami, 10 października 2026 r.
TestRodzajWynik przed poprawkami
axe-core w PlaywrightAutomatyczny6 naruszeń
Pomiar kontrastu tekstu na zdjęciach piksel po pikseluSkrypt29 elementów poniżej progu na 10 stronach
Odstępy tekstu (1.4.12)Skrypt5 miejsc z uciętym tekstem
Nawigacja samą klawiaturąRęczny2 komponenty z niewidocznym fokusem
Kryteria
55

kryteriów sukcesu WCAG 2.2 A i AA, każde ze statusem w raporcie

Adresy
48

adresów EN i PL w audycie naszej strony

Kontrast po poprawkach
0

z 2140 zmierzonych elementów tekstu na zdjęciach poniżej progu na naszej stronie

Uwagi
16

ponumerowanych uwag z nagraniami z webowej rundy testów z czytnikiem ekranu w PSONI

Rozmiary czcionki
3

rozmiary tekstu w aplikacji PSONI: 100%, 150% i 200%

Za oknem dialogowym
25

kontrolek, do których VoiceOver mógł dotrzeć za oknem z 4 kontrolkami, zanim to naprawiliśmy

Pytania o audyt dostępności

O co pytają klienci przed zamówieniem audytu WCAG

Daria Gusieva
Daria Gusieva
Head of Design
Umów bezpłatną konsultację
  • Nie, automatyczny skan znajduje tylko część błędów WCAG. Na naszej stronie axe znalazł 6 naruszeń, a testy ręczne i pomiar kontrastu piksel po pikselu wykryły 29 elementów tekstu ze słabym kontrastem na zdjęciach, 5 miejsc z uciętym tekstem i 2 komponenty z niewidocznym fokusem. Część kryteriów może ocenić tylko człowiek.

  • Tak, ten sam zespół, który robi audyt, projektuje i programuje poprawki w React, React Native i Django, a potem robi retest. W aplikacji Centrum Komunikacji naprawiliśmy na przykład okno dialogowe, z którego VoiceOver mógł przejść z 4 kontrolek na 25 kontrolek ukrytych za nim.

  • Tak, aplikacje mobilne testujemy z VoiceOver na iOS i z TalkBack na Androidzie w osobnych rundach, bo te same ekrany zachowują się na nich inaczej. W projekcie PSONI rundy testów z czytnikiem ekranu na webie i na telefonach odbywają się po kolei.

  • Koszt i czas audytu dostępności zależą od próbki ekranów i procesów oraz od liczby platform. Każda platforma testowana z czytnikiem ekranu to osobna runda, dlatego wycenę podajemy po ustaleniu zakresu.

  • Raport z audytu pokazuje stan każdego kryterium, ale pełna zgodność zależy też od treści, np. napisów do filmów, które musi przygotować właściciel treści. Pokazał to audyt naszej strony: poprawki w kodzie są wdrożone, a strona jest częściowo zgodna, po części dlatego, że 7 z 10 naszych filmów ma tylko automatyczne napisy, a po części dlatego, że test z czytnikiem ekranu jest jeszcze przed nami.

  • Domyślnie audytujemy według WCAG 2.2 na poziomie AA. Jeśli umowa lub przepisy wymagają innej wersji, np. WCAG 2.1 AA u podmiotu publicznego, audytujemy według niej.

  • Raport zawiera tabelę wszystkich 55 kryteriów sukcesu WCAG na poziomach A i AA ze statusem każdego oraz listę problemów z kryterium, miejscem, krokami odtworzenia, oczekiwanym wynikiem i priorytetem. Zespół może od razu przenieść te problemy do backlogu.

  • Europejski akt o dostępności od 28 czerwca 2025 r. obejmuje wybrane produkty i usługi cyfrowe, m.in. bankowość, e-commerce i e-booki. Czy obejmuje Twoją usługę, oceni prawnik; my sprawdzimy produkt pod kątem WCAG i poprawimy to, co nie spełnia wymagań.

Więcej naszych projektów

Case study projektu UX naszego zespołu projektowego

Contact image

Napisz, czego ma dotyczyć audyt

Twoja wiadomość trafi do

Filip Szamborski

Filip Szamborski

Co-founder & CEO

DOTĄD PRACOWALIŚMY M.IN. Z:

Dziękujemy za wiadomość.

Każdą wiadomość czytamy sami i odpowiadamy w ciągu 48 godzin w dni robocze.

Coś pilnego? hello@ordergroup.co

Porozmawiajmy o audycie dostępności

Napisz, jaki to produkt, na jakich działa platformach i której wersji WCAG potrzebujesz, a wrócimy z propozycją zakresu audytu.

Pola oznaczone gwiazdką (*) są wymagane.

Order Group sp. z o.o. wykorzysta podane dane tylko po to, żeby odpowiedzieć na Twoje zapytanie i zachować informację o nim (art. 6 ust. 1 lit. b i f RODO). Szczegóły, w tym Twoje prawa, znajdziesz w naszej Polityce prywatności (otwiera się w nowej karcie).

Odpowiadamy w ciągu 48 godzin w dni robocze - człowiek, nie autoresponder.

Korzystasz z asystenta AI? Może wysłać to zapytanie za Ciebie albo przygotować wypełniony formularz - instrukcję znajdzie w llms.txt.

Ustawienia dostępności

Rozmiar tekstu

100%