Dostępność cyfrowa WCAG 2.2 AA Szukaj Kontakt
Czytanie i wygląd Ustaw stronę dla siebie

Czytanie i wygląd

Zmiany wyglądu działają również przy wyłączonym asystencie. Nie zastępują dostępności strony.

Wygląd strony

Ustawienia zapisujemy tylko w tej przeglądarce. Przywrócenie wyglądu usuwa ten zapis. Powiększenie przeglądarki pozostaje dostępne niezależnie.

Czytanie treści

Usługa głosu zostanie sprawdzona po otwarciu panelu.

Czytamy widoczną treść główną. Pomijamy menu, formularze i panele boczne. Nie używamy mikrofonu. Przy wyborze głosu asystenta czytany tekst trafia do skonfigurowanej usługi mowy. Nie przełączamy automatycznie na inny głos.

WCAG AKADEMIA LABORATORIUM

Praktyczny przewodnik • WCAG 2.2 AA

Kod, semantyka i ARIA w praktyce

Dwie strony mogą wyglądać identycznie, ale przekazywać zupełnie inne informacje technologiom asystującym. Poznaj różnicę w rzeczywistym kodzie.

15 praktycznych przykładów4 krótkie ćwiczeniaBez logowania
Najpierw HTML, potem ARIA. Ten moduł pokazuje poprawne wzorce i typowe błędy. Komunikaty technologii asystujących są ilustracyjne — zależą od programu, systemu i ustawień.

MODUŁ 01

Najpierw semantyczny HTML

Elementy HTML określają funkcję i znaczenie, nie tylko wygląd.

Link czy przycisk?

Link prowadzi do zasobu; przycisk wykonuje działanie w bieżącym interfejsie.

Podgląd poprawnego rozwiązania

Poprawnie

<a href="/kursy">Zobacz kursy</a>
<button type="button">Zapisz</button>

Typowy błąd

Element div imitujący link bez semantyki i obsługi klawiatury.

Pokaż błędny kod
<div onclick="location.href='/kursy'">Zobacz kursy</div>

Przykładowa interpretacja przez technologię asystującą

Przykładowo: „Zobacz kursy, link” oraz „Zapisz, przycisk”.

Dlaczego to jest ważne?

Prawidłowy element zapewnia semantykę i przewidywalną obsługę klawiatury.

Powiązane WCAG 2.2:
  • 1.3.1
  • 2.1.1
  • 4.1.2

Zrozumiały tekst linku

Cel linku powinien wynikać z jego nazwy albo programowo określonego kontekstu.

Podgląd poprawnego rozwiązania

Poprawnie

<a href="/rekrutacja">Zasady rekrutacji</a>

Typowy błąd

Ogólna etykieta nie opisuje celu.

Pokaż błędny kod
<a href="/rekrutacja">Kliknij tutaj</a>

Przykładowa interpretacja przez technologię asystującą

Przykładowo: „Zasady rekrutacji, link”.

Dlaczego to jest ważne?

Lista linków odczytywana poza kontekstem pozostaje użyteczna.

Powiązane WCAG 2.2:
  • 2.4.4

MODUŁ 02

Struktura dokumentu

Ułatwiaj poruszanie się po treści, tabelach i obszarach strony.

Nagłówki i ich hierarchia

Nagłówki wyznaczają logiczny konspekt treści.

Poprawnie

<h1>Poradnik dostępności</h1>
<h2>Formularze</h2>
<h3>Etykiety pól</h3>

Typowy błąd

Powiększony i pogrubiony akapit zamiast nagłówka.

Pokaż błędny kod
<p class="duzy-pogrubiony">Formularze</p>

Przykładowa interpretacja przez technologię asystującą

Przykładowo: „Formularze, nagłówek poziomu drugiego”.

Dlaczego to jest ważne?

Czytniki ekranu umożliwiają nawigację po nagłówkach.

Powiązane WCAG 2.2:
  • 1.3.1
  • 2.4.6

Rzeczywiste listy

Listy zapisujemy jako ul/ol i li, nie jako zwykłe akapity z myślnikiem.

Podgląd poprawnego rozwiązania

  • Kontrast tekstu
  • Obsługa klawiaturą

Poprawnie

<ul>
  <li>Kontrast</li>
  <li>Klawiatura</li>
</ul>

Typowy błąd

Myślniki wpisane w osobnych akapitach.

Pokaż błędny kod
<p>- Kontrast</p>
<p>- Klawiatura</p>

Przykładowa interpretacja przez technologię asystującą

Przykładowo: „Lista, dwa elementy”.

Dlaczego to jest ważne?

Relacje i liczba elementów mogą być komunikowane użytkownikowi.

Powiązane WCAG 2.2:
  • 1.3.1

Landmarki i główna treść

Semantyczne obszary strony ułatwiają szybkie przemieszczanie się.

Poprawnie

<header>...</header>
<nav aria-label="Menu główne">...</nav>
<main id="main-content">...</main>
<footer>...</footer>

Typowy błąd

Użycie samych div zamiast odpowiednich elementów strukturalnych.

Pokaż błędny kod
<div class="naglowek">...</div>
<div class="tresc">...</div>

Przykładowa interpretacja przez technologię asystującą

Przykładowo: „Nawigacja, Menu główne” oraz „Główna treść”.

Dlaczego to jest ważne?

Nazwane obszary pomagają znaleźć istotne części dokumentu.

Powiązane WCAG 2.2:
  • 1.3.1
  • 2.4.1

Tabele danych

Tabela danych potrzebuje nagłówków, a często także podpisu.

Podgląd poprawnego rozwiązania

Terminy zajęć
DzieńGodzina
Poniedziałek09:00

Poprawnie

<table>
  <caption>Terminy zajęć</caption>
  <thead><tr><th scope="col">Dzień</th><th scope="col">Godzina</th></tr></thead>
  <tbody><tr><td>Poniedziałek</td><td>09:00</td></tr></tbody>
</table>

Typowy błąd

Nagłówki kolumn oznaczone zwykłymi td.

Pokaż błędny kod
<table><tr><td>Dzień</td><td>Godzina</td></tr><tr><td>Poniedziałek</td><td>09:00</td></tr></table>

Przykładowa interpretacja przez technologię asystującą

Przykładowo: „Terminy zajęć, tabela”, z powiązaniem danych z nagłówkami kolumn.

Dlaczego to jest ważne?

Relacje komórek z nagłówkami można odczytać bez interpretowania układu wzrokowego.

Powiązane WCAG 2.2:
  • 1.3.1

Obrazy i tekst alternatywny

Opis alternatywny zależy od roli obrazu w danym kontekście.

Poprawnie

<img src="schemat.png" alt="Schemat: trzy etapy rekrutacji">

Typowy błąd

Opis nazwy pliku zamiast znaczenia obrazu.

Pokaż błędny kod
<img src="schemat.png" alt="obrazek123">

Przykładowa interpretacja przez technologię asystującą

Przykładowo: „Schemat: trzy etapy rekrutacji, grafika”.

Dlaczego to jest ważne?

Użytkownik otrzymuje informację istotną dla treści; dekoracyjne obrazy wymagają alt="".

Powiązane WCAG 2.2:
  • 1.1.1

MODUŁ 03

Formularze i komunikaty

Nazwy, instrukcje i błędy muszą być czytelne oraz programowo dostępne.

Etykieta formularza

Pole powinno mieć programowo powiązaną, widoczną etykietę.

Podgląd poprawnego rozwiązania

Poprawnie

<label for="email">Adres e-mail</label>
<input id="email" type="email" autocomplete="email">

Typowy błąd

Pole opisane wyłącznie placeholderem.

Pokaż błędny kod
<input type="email" placeholder="Adres e-mail">

Przykładowa interpretacja przez technologię asystującą

Przykładowo: „Adres e-mail, pole edycji”.

Dlaczego to jest ważne?

Etykieta nie znika po rozpoczęciu wpisywania.

Powiązane WCAG 2.2:
  • 1.3.1
  • 3.3.2
  • 4.1.2

Wskazówki przez aria-describedby

Dodatkowa instrukcja może być powiązana z polem bez zastępowania etykiety.

Podgląd poprawnego rozwiązania

Co najmniej 12 znaków.

Poprawnie

<label for="haslo">Hasło</label>
<p id="pomoc">Co najmniej 12 znaków.</p>
<input id="haslo" type="password" aria-describedby="pomoc">

Typowy błąd

Brak widocznej instrukcji i poleganie na samej nazwie ARIA.

Pokaż błędny kod
<input type="password" aria-label="Hasło">

Przykładowa interpretacja przez technologię asystującą

Przykładowo: „Hasło, pole hasła. Co najmniej 12 znaków”.

Dlaczego to jest ważne?

Wskazówka jest programowo dostępna i widoczna.

Powiązane WCAG 2.2:
  • 3.3.2
  • 1.3.1

Błędy i ich identyfikacja

Komunikat musi wskazać konkretny problem i być powiązany z polem.

Podgląd poprawnego rozwiązania

Poprawnie

<label for="kod">Kod pocztowy</label>
<input id="kod" aria-invalid="true" aria-describedby="kod-blad">
<p id="kod-blad">Wpisz kod w formacie 00-000.</p>

Typowy błąd

Sama czerwona obwódka bez komunikatu tekstowego.

Pokaż błędny kod
<input class="czerwona-ramka">

Przykładowa interpretacja przez technologię asystującą

Przykładowo: „Kod pocztowy, nieprawidłowe dane. Wpisz kod w formacie 00-000”.

Dlaczego to jest ważne?

Informacja o błędzie nie jest przekazana wyłącznie kolorem.

Powiązane WCAG 2.2:
  • 3.3.1
  • 1.4.1
  • 4.1.2

MODUŁ 04

ARIA i interakcje

ARIA uzupełnia natywne elementy. Przykłady kodu statusów pokazują także, kiedy aktualizować treść; rzeczywiste ogłoszenia zależą od technologii asystującej.

Komunikaty statusu: aria-live

Ważne zmiany treści można ogłaszać bez przesuwania fokusu.

Podgląd poprawnego rozwiązania

Poprawnie

<p id="status" role="status"></p> <!-- Po wykonaniu akcji: status.textContent = "Zapisano zmiany." -->

Typowy błąd

Nowy tekst pojawia się wizualnie, lecz nie jest ogłaszany.

Pokaż błędny kod
<p class="zielony">Zapisano zmiany.</p>

Przykładowa interpretacja przez technologię asystującą

Przykładowo: po zmianie treści może zostać ogłoszone „Zapisano zmiany”.

Dlaczego to jest ważne?

Użytkownik może otrzymać informację o wyniku działania bez szukania nowego tekstu.

Powiązane WCAG 2.2:
  • 4.1.3

Ważny błąd: role="alert"

Alert stosuj oszczędnie do pilnych informacji wymagających uwagi.

Podgląd poprawnego rozwiązania

Poprawnie

<div id="blad" role="alert"></div> <!-- Po błędzie: blad.textContent = "Nie udało się zapisać formularza." -->

Typowy błąd

Brak mechanizmu powiadomienia o dynamicznym błędzie.

Pokaż błędny kod
<div>Nie udało się zapisać formularza.</div>

Przykładowa interpretacja przez technologię asystującą

Przykładowo: komunikat może zostać ogłoszony bez ręcznego przechodzenia do niego.

Dlaczego to jest ważne?

Pilny błąd nie pozostaje wyłącznie komunikatem wizualnym.

Powiązane WCAG 2.2:
  • 4.1.3

Rozwijanie treści: aria-expanded

Stan przycisku rozwijającego powinien odpowiadać stanowi panelu.

Podgląd poprawnego rozwiązania

Poprawnie

<button type="button" aria-expanded="false" aria-controls="filtry">Filtry</button>
<div id="filtry" hidden>...</div>
<!-- Skrypt musi aktualizować hidden i aria-expanded razem. -->

Typowy błąd

Div bez natywnej obsługi przycisku i bez stanu.

Pokaż błędny kod
<div onclick="rozwin()">Filtry ▼</div>

Przykładowa interpretacja przez technologię asystującą

Przykładowo: „Filtry, przycisk, zwinięty”.

Dlaczego to jest ważne?

ARIA przekazuje stan, ale zmiana stanu musi być zsynchronizowana ze zmianą widoczności.

Powiązane WCAG 2.2:
  • 2.1.1
  • 4.1.2

Bieżąca strona: aria-current

Zaznacz bieżący element nawigacji znacznikiem aria-current="page".

Poprawnie

<a href="/laboratorium" aria-current="page">Laboratorium</a>

Typowy błąd

Stan aktywny jest widoczny, ale nie jest przekazywany programowo.

Pokaż błędny kod
<a href="/laboratorium" class="aktywny">Laboratorium</a>

Przykładowa interpretacja przez technologię asystującą

Przykładowo: „Laboratorium, bieżąca strona, link”.

Dlaczego to jest ważne?

Wskazanie aktywnej lokalizacji nie opiera się tylko na kolorze.

Powiązane WCAG 2.2:
  • 1.3.1
  • 4.1.2

Przeskocz do treści i widoczny fokus

Skrót pozwala ominąć powtarzalną nawigację. Fokus musi pozostawać widoczny.

Poprawnie

<a class="skip-link" href="#main-content">Przejdź do treści</a>
<main id="main-content">...</main>

Typowy błąd

Wykluczenie skip linku z naturalnej kolejności Tab.

Pokaż błędny kod
<a href="#main-content" tabindex="-1">Przejdź do treści</a>

Przykładowa interpretacja przez technologię asystującą

Przykładowo: „Przejdź do treści, link”.

Dlaczego to jest ważne?

Osoby korzystające z klawiatury mogą szybko przejść do treści bez przechodzenia przez menu.

Powiązane WCAG 2.2:
  • 2.4.1
  • 2.4.7
  • 2.4.11

SPRAWDŹ WIEDZĘ

4 pytania, które sprawdzają podstawy

Bez oceniania i bez zapisywania danych. Wybierz odpowiedź i od razu sprawdź uzasadnienie.

Demonstracje, kopiowanie kodu oraz sprawdzanie odpowiedzi wymagają JavaScript. Treści przykładów pozostają dostępne.

01 Element ma przenieść użytkownika na podstronę z kursami. Co wybierasz?
02 Jak należy oznaczyć dwuelementową listę?
03 Jaki element jest domyślnym wyborem dla akcji „Zapisz”?
04 Czy placeholder zastępuje widoczną etykietę label?

Podsumowanie ćwiczeń

Sprawdzone odpowiedzi: 0 z 4.

Poprawne odpowiedzi: 0 z 4.

Asystent korzysta z AI. Odpowiedzi mogą wymagać weryfikacji.

Jak działa AI?

Funkcje AI w WCAG Akademii są obecnie wykonywane na prywatnej, lokalnej stacji obliczeniowej operatora projektu, działającej w prywatnej infrastrukturze domowej.

Obecna stacja wykorzystuje NVIDIA RTX A5000 z 24 GB pamięci VRAM, około około 128 GB RAM oraz 2× Intel Xeon E5-2667 v4, łącznie 32 wątki.

W zależności od zadania wykorzystywane są lokalne modele:

  • wcag-fast — szybkie odpowiedzi asystenta.
  • wcag-documents — dokumenty, treści i ETR.
  • wcag-general — ogólna analiza treści.
  • wcag-master — bardziej złożona analiza i kontrola jakości.
  • qwen3-embedding — wyszukiwanie w lokalnej bazie wiedzy RAG.

Lokalne przetwarzanie na pojedynczej stacji roboczej może być wolniejsze niż usługi dużych centrów danych. Prostsze zadania zwykle kończą się szybciej, a analiza dokumentów, ETR lub większych materiałów może wymagać kilkunastu albo kilkudziesięciu sekund.

Projekt jest rozwijany. Wraz ze wzrostem liczby użytkowników infrastruktura będzie stopniowo modernizowana.

AI może popełnić błąd. Wynik jest pomocą w pracy, a nie automatycznym potwierdzeniem zgodności z WCAG, ETR, RODO ani innymi przepisami.

Nie wprowadzaj danych osobowych ani informacji poufnych, jeżeli nie są potrzebne do wykonania zadania.

Zgłoś problem z odpowiedzią AI
Co jest nie tak?

Nie wklejaj danych osobowych ani poufnych informacji. Wystarczy krótko opisać problem.