Przejdź do treści
Pandus

Testowanie dostępności aplikacji webowych: czym różni się od strony

Aplikację webową testuje się według tego samego standardu co stronę, WCAG 2.2 AA, ale jej problemy kryją się w stanach, do których crawler nigdy nie dociera: okno dialogowe, zmieniona trasa, przefiltrowana tabela za logowaniem. Działający plan ma cztery warstwy: automatyczne sprawdzenia w CI na rzeczywistych stanach, sprawdzanie ekranów po zalogowaniu, krótki skrypt klawiaturowy i żywe sygnały od użytkowników.

Autor: , założyciel Pandus · Zaktualizowano 21 października 2026 · 4 min czytania · Jak piszemy i sprawdzamy nasze poradniki

Na stronie jednostką jest podstrona: otwierasz URL, treść jest na miejscu, sprawdzarka ją czyta. W aplikacji webowej jednostką jest stan. Ten sam URL pokazuje pustą listę, kółko ładowania, przefiltrowaną tabelę albo błąd, zależnie od tego, co zrobił użytkownik. Strona logowania to jedyne, co widzi crawler, a problemy rzadko są właśnie tam.

Ten poradnik jest dla zespołów budujących produkty SaaS, portale i narzędzia wewnętrzne. Zakłada, że znasz listę kontrolną WCAG 2.2 i chcesz wiedzieć, gdzie ją skierować.

Gdzie aplikacje webowe się psują

Sześć miejsc odpowiada za większość blokerów, które widzimy w aplikacjach:

  1. Zmiana trasy bez zarządzania fokusem. W aplikacji jednostronicowej zmienia się URL, zmienia się treść, ale fokus zostaje na linku, którego już nie ma. Użytkownik czytnika ekranu nie słyszy nic. Rozwiązanie: przenieść fokus na nagłówek lub główny region nowego widoku i zaktualizować tytuł dokumentu.
  2. Okna dialogowe. Okno musi przejąć fokus przy otwarciu, trzymać Tab w środku, zamykać się klawiszem Escape i zwracać fokus do kontrolki, która je otworzyła. Większość własnych okien zawodzi w co najmniej jednym punkcie; zobacz wzorzec okna modalnego.
  3. Powiadomienia i aktualizacje na żywo. Komunikat, który na trzy sekundy pojawia się w rogu, jest niewidoczny dla czytnika ekranu, jeśli nie jest w regionie na żywo. Komunikaty o statusie to kryterium WCAG 2.2 (4.1.3).
  4. Własne kontrolki. Comboboxy, wybory daty, suwaki i przełączniki zbudowane z elementów div nie mają roli, nazwy ani obsługi klawiatury, dopóki ktoś ich nie doda. Wzorzec select i combobox pokazuje oczekiwane zachowanie.
  5. Tabele i listy z akcjami. Rząd przycisków-ikon (edytuj, usuń, pobierz) bez dostępnej nazwy czyta się jako „przycisk, przycisk, przycisk”. Zwirtualizowane listy renderujące tylko widoczne wiersze mylą czytniki ekranu, które czytają całą listę.
  6. Formularze z walidacją w locie. Błędy, które pojawiają się obok pola, ale nie są z nim powiązane, lub są ogłaszane, zanim użytkownik skończy pisać. Wzorzec błędów formularza opisuje powiązania.

Nic z tego nie jest egzotyczne. To zwykłe elementy składowe aplikacji, a każdy z nich jest niewidoczny dla sprawdzenia działającego na stronie logowania.

Warstwa 1: automatyczne sprawdzenia w CI na rzeczywistych stanach

Uruchamiaj otwarty silnik axe-core w testach end-to-end, w stanie, który chcesz sprawdzić: po zalogowaniu, po otwarciu okna, po zastosowaniu filtra. Playwright z @axe-core/playwright to typowa konfiguracja; nasz poradnik o testach dostępności w Playwright ma kod i zestaw reguł zgodny ze skanerem Pandus, więc CI i cotygodniowe sprawdzenie się zgadzają.

Trzy nawyki czynią to użytecznym, a nie hałaśliwym:

  • Zatrzymuj build tylko na wynikach serious i critical; resztę zostaw jako raport.
  • Testuj stany, nie strony: jeden test na okno, na pusty stan, na stan błędu.
  • Sprawdzaj tytuł dokumentu i fokus po każdej zmianie trasy w tym samym teście.

Warstwa 2: ekrany po zalogowaniu w przeglądarce

CI pokrywa to, co postanowiłeś przetestować. Rozszerzenie Pandus pokrywa to, co masz otwarte teraz: środowisko testowe, panel administracyjny, konto klienta z prawdziwymi danymi. Uruchamia te same reguły, wyjaśnia każdy problem prostym językiem i kopiuje notatkę dla dewelopera lub prompt dla asystenta AI. Narzędzia kolejności Tab i fokusu pokazują kolejność, którą napotkają użytkownicy klawiatury, a to najczęstsza niespodzianka w aplikacji.

Warstwa 3: dziesięć minut z klawiaturą

Automatyzacja nie ocenia, czy kolejność ma sens ani czy powiadomienie zostało usłyszane. Krótki skrypt to ocenia i mieści się w przeglądzie sprintu:

  1. Odłącz mysz, otwórz stronę logowania i zaloguj się tylko klawiszami Tab i Enter. Czy na każdym kroku widzisz, gdzie jesteś?
  2. Otwórz główne okno produktu. Czy fokus do niego przechodzi? Czy Escape je zamyka i przywraca Cię z powrotem?
  3. Wywołaj komunikat o sukcesie i błąd. Czy z włączonym czytnikiem ekranu (NVDA, VoiceOver) są ogłaszane?
  4. Użyj głównej tabeli lub listy: sortuj, filtruj, otwórz wiersz, wykonaj akcję w wierszu. Czy gdziekolwiek potrzebowałeś myszy?
  5. Zmień trasę z nawigacji. Gdzie jest teraz fokus i co mówi tytuł?

Tam, gdzie utknąłeś, utkną też użytkownicy klawiatury, przełącznika lub czytnika ekranu. Zapisz pięć odpowiedzi; to ręczna część Twojej strony o dostępności.

Warstwa 4: żywe sygnały od prawdziwych użytkowników

Trzy warstwy powyżej testują to, co postanowiłeś przetestować. Pandus SDK raportuje, na co użytkownicy naprawdę natrafili: fokus klawiatury uwięziony na ekranie, fokus zgubiony po zamknięciu okna, kontrolka bez nazwy, w którą ludzie klikali raz po raz, błąd formularza, którego nigdy nie ogłoszono, układ, który się rozsypał przy powiększeniu. Każdy sygnał niesie stronę, element i kryterium WCAG, a sygnały są liczone, więc pierwsza poprawka to ta, która dotyka najwięcej użytkowników. Na próbce odsłon SDK uruchamia też axe-core na rzeczywistym stanie aplikacji, zastępując każdy tekst, zanim cokolwiek opuści przeglądarkę.

Po poprawce skaner sprawdza ponownie, a żywy sygnał jest obserwowany przez ustaloną liczbę dni. „Potwierdzone przez prawdziwych odwiedzających” to lepszy status niż „zamknięte”.

Co zapisać

Kupujący aplikacje webowe proszą o dowody. Utrzymuj aktualne trzy rzeczy:

  • Stronę o dostępności z datą ostatniego sprawdzenia, standardem (WCAG 2.2 AA), znanymi ograniczeniami i sposobem zgłoszenia bariery. Poradnik deklaracji dostępności ma szablon; Pandus tworzy szkic z ankiety.
  • Accessibility Conformance Report w formacie VPAT, gdy wśród Twoich klientów są podmioty publiczne lub duże organizacje. Pandus generuje szkic z automatycznego sprawdzenia w planach Agency; kolumny ręczne wymagają człowieka.
  • Listę otwartych problemów z właścicielami i terminami, wyeksportowaną do Jiry lub GitHuba, by następny sprint ją miał.

Sprawdzenia automatyczne, rozszerzenie i SDK znajdują część problemów; skrypt klawiaturowy i przegląd ręczny znajdują resztę. W każdym raporcie mówimy, że to sprawdzenie automatyczne, a nie pełny audyt, i nic tutaj nie jest poradą prawną.

Poradniki i narzędzia

Artykuły pomocy