Wprowadzenie
Dostępna strona jest wygodniejsza dla wszystkich, nie tylko dla osób z niepełnosprawnościami. Do tego zmniejsza ryzyko prawne, trafia do szerszego grona odbiorców, a także poprawia widoczność w wyszukiwarkach (SEO) i wydajność. Poniżej opisujemy pięć konkretnych, technicznych kroków, które można szybko wdrożyć. Przy każdym wyjaśniamy, co zrobić, dlaczego to ważne i jak to sprawdzić.
Krok 1 – Pisz sensowne teksty alternatywne (alt) i opisowe linki
Co: Nadaj obrazom krótkie, sensowne atrybuty alt, a linkom – jasne, opisowe treści.
Dlaczego: Na tych informacjach opierają się czytniki ekranu i inne technologie wspomagające, gdy opisują treść i nawigację.
Jak to zrobić:
-
Obrazy dekoracyjne → pusty
alt: alt=""irole="presentation". -
Obrazy informacyjne → opisowy
alt, który mówi, czemu obraz służy (a nie jak wygląda w szczegółach). -
Obrazy złożone (wykresy, diagramy) → dodaj podpis albo dłuższy opis w tekście obok lub przez
aria-describedby. -
Treść linku powinna mówić, dokąd prowadzi (unikaj samego „kliknij tutaj” czy „czytaj więcej”).
Przykłady:
<!-- Decorative -->
<img src="/pattern.svg" alt="" role="presentation" />
<!-- Informative -->
<img src="/team-portrait.jpg" alt="Four developers in the Byte Buddy office, smiling" />
<!-- Complex image with description -->
<img src="/sales-chart.png" alt="Quarterly sales chart" aria-describedby="chartDesc" />
<p id="chartDesc">Sales rose 12% in Q2 driven by product X; see table below for values.</p>
<!-- Descriptive link -->
<a href="/pdf/report-2025.pdf">Download the 2025 Accessibility Report (PDF, 2.1 MB)</a>
Szybki test:
-
Wyłącz obrazy w przeglądarce. Czy strona nadal jest zrozumiała?
-
Włącz czytnik ekranu (NVDA, VoiceOver) i posłuchaj, jak brzmią opisy obrazów i linków.
Krok 2 – Zadbaj o kontrast i nie przekazuj informacji samym kolorem
Co: Tekst i elementy interfejsu muszą mieć odpowiedni współczynnik kontrastu, a znaczenia nie wolno przekazywać wyłącznie kolorem.
Dlaczego: Przy słabym kontraście treść jest nieczytelna dla osób słabowidzących i na wielu starszych urządzeniach czy ekranach. Informacja przekazana tylko kolorem nie dotrze do osób z daltonizmem.
Jak to zrobić:
- Spełnij minimalne wartości kontrastu według WCAG:
- Zwykły tekst: co najmniej 4,5:1
- Duży tekst (≥18 pt albo pogrubiony ≥14 pt): co najmniej 3:1
- Elementy interfejsu i obiekty graficzne: w wielu przypadkach co najmniej 3:1
-
Jeśli kolor oznacza stan, dodaj drugą wskazówkę wizualną (np. ikonę, podkreślenie, etykietę tekstową).
-
Unikaj małego tekstu na tle o słabym kontraście (przyciski, plakietki).
Wskazówka CSS (czytelne rozmiary i wartości domyślne):
body { font-size: 16px; line-height: 1.4; color: #111; background: #fff; }
/* Ensure focus-visible has strong contrast */
a:focus, button:focus {
outline: 3px solid #005a9c; /* visible, meets contrast */
outline-offset: 3px;
}
Szybki test:
-
Sprawdź narzędziem do badania kontrastu najczęściej używane elementy (nagłówek, stopka, przyciski).
-
Przełącz stronę w odcienie szarości (w narzędziach dla programistów albo rozszerzeniem przeglądarki). Jeśli jakaś informacja znika, przekazujesz ją samym kolorem.
Krok 3 – Obsługa z klawiatury i widoczny fokus
Co: Każdy element interaktywny musi dać się obsłużyć z klawiatury (Tab, Enter, spacja, strzałki), a element z fokusem musi mieć widoczny wskaźnik fokusu.
Dlaczego: Wiele osób korzysta z klawiatury albo innych urządzeń wejściowych (przełączników, czytników ekranu). Bez obsługi z klawiatury nie dostaną się do treści.
Jak to zrobić:
- Upewnij się, że każdy element interaktywny może otrzymać fokus (<button>, <a href> i <input> robią to same; własne kontrolki muszą mieć tabindex, obsługę zdarzeń klawiatury i role ARIA).
- Korzystaj z natywnej semantyki: nie zamieniaj <div> w przycisk, chyba że zapewnisz mu pełną obsługę z klawiatury i wszystkie cechy dostępności.
- Zadbaj o wyraźny, zawsze widoczny styl fokusu (nie usuwaj obrysu, jeśli nie dajesz nic w zamian).
Przykład dostępnej własnej kontrolki:
<!-- Bad: non-focusable div -->
<div class="toggle" onclick="toggle()">On</div>
<!-- Good: semantic button -->
<button class="toggle" aria-pressed="false">On</button>
Szybki test:
-
Przejdź przez stronę samą klawiaturą, bez myszy. Czy docierasz do wszystkich elementów interaktywnych? Czy da się je uruchomić?
-
Tam, gdzie to ma sens (menu, listy, karuzele), użyj też
Shift + Tabi strzałek.
Krok 4 – Używaj semantycznego HTML i poprawnie stosuj ARIA
Co: Wybieraj semantyczne elementy HTML (<nav>, <main>, <header>, <footer>, <button>, <form>, nagłówki h1..h6), a ARIA stosuj tylko tam, gdzie brakuje semantyki.
Dlaczego: Semantyczny HTML to podstawa dostępności – daje strukturę technologiom wspomagającym i wyszukiwarkom. Źle użyte ARIA może bardziej zaszkodzić, niż pomóc.
Jak to zrobić:
-
Zachowaj poprawną strukturę nagłówków: jeden <h1> na stronie, potem po kolei <h2> i <h3>. Nagłówki muszą odzwierciedlać hierarchię dokumentu.
-
Punkty orientacyjne (landmarks), takie jak <main>, <nav> i <aside>, ułatwiają poruszanie się po stronie osobom korzystającym z czytników ekranu.
-
Role, stany i właściwości ARIA stosuj tylko wtedy, gdy natywny HTML nie potrafi wyrazić danej roli lub stanu (np. role="dialog" dla własnego okna modalnego, aria-expanded dla własnego elementu rozwijanego).
-
Nie dodawaj role="presentation" do elementów, które zawierają istotną treść.
Przykłady:
<header>
<h1>Byte Buddy — Dev Tutorials</h1>
<nav aria-label="Main Navigation">...</nav>
</header>
<main id="content">
<article>
<h2>How to Use Semantic HTML</h2>
<p>...</p>
</article>
</main>
Szybki test:
-
Sprawdź nagłówki w narzędziach dla programistów. Czy następują po sobie w logicznej kolejności?
-
Obejrzyj drzewo dostępności (Lighthouse, axe, panel dostępności w przeglądarce) i sprawdź punkty orientacyjne oraz role.
Krok 5 – Twórz dostępne formularze: etykiety, instrukcje i czytelne komunikaty o błędach
Co: Każde pole formularza potrzebuje etykiety, instrukcje muszą być z polami powiązane programowo, a błędy – jasno opisane i odczytywane przez czytnik ekranu.
Dlaczego: Formularze to jedne z najczęściej używanych elementów strony. Jeśli są niedostępne, użytkownik nie zarejestruje się, nie sfinalizuje zamówienia ani nie wyśle zgłoszenia.
Jak to zrobić:
-
Powiąż pola z
<label for="id">albo umieść pole wewnątrz elementu<label>. -
Tekst pomocniczy i komunikaty o błędach połącz z polem przez
aria-describedby. -
Przy walidacji przenieś fokus na pierwsze błędne pole i upewnij się, że komunikaty o błędach są programowo powiązane z polami, tak by odczytał je czytnik ekranu.
-
Nie zastępuj etykiet samym tekstem zastępczym (placeholder to nie etykieta).
Przykład:
<label for="email">Email address</label>
<input id="email" name="email" type="email"
aria-describedby="emailHelp emailError" />
<p id="emailHelp">We'll use this to send receipts.</p>
<p id="emailError" role="alert" aria-live="assertive" hidden>
Enter a valid email address.
</p>
Szybki test:
-
Wyślij formularz z błędnymi danymi. Czy błędy są odczytywane? Czy fokus przechodzi do błędu?
-
Przejdź przez formularz i wypełnij go samą klawiaturą. Czy etykiety i instrukcje są widoczne i zrozumiałe?
Narzędzia i materiały w skrócie
-
Testy automatyczne: axe DevTools, Lighthouse.
-
Testy z klawiaturą i czytnikiem ekranu: NVDA (Windows), VoiceOver (macOS/iOS), nawigacja wyłącznie za pomocą klawiatury.
-
Narzędzia do sprawdzania kontrastu i symulatory daltonizmu (jako rozszerzenia lub w narzędziach, z których już korzystasz).
-
Skrócona dokumentacja WCAG dla poziomów A / AA / AAA (stosuj WCAG 2.1 lub nowszą wersję).
Na koniec
Zacznij od tych pięciu kroków: to zmiany, które programista może wprowadzić sam, a które dają największy efekt. Łącz testy automatyczne z ręcznymi (klawiatura i czytnik ekranu), żeby wychwycić to, co umknie narzędziom. Dostępność to proces, a nie jednorazowe zadanie: wprowadź zmiany, przetestuj je i pilnuj regresji w CI/CD za pomocą narzędzi automatycznych.



