Skip to main contentOpen accessibility widget
Development

Jak poprawić dostępność strony internetowej: 5 prostych kroków

Pięć praktycznych kroków, którymi programista od razu poprawi dostępność strony.

Author avatar

Petar Hristovski

Author

A simple illustration of a developer at a laptop with accessibility icons and the title “How to Improve Your Website’s Accessibility in 5 Easy Steps.”

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="" i role="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:
  1. Zwykły tekst: co najmniej 4,5:1
  2. Duży tekst (≥18 pt albo pogrubiony ≥14 pt): co najmniej 3:1
  3. 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 + Tab i 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.

Share this post

You might also like

Two more articles worth reading while this topic is still fresh.

Wordpress Integration cover image

Widżet dostępności EaseAccess24 w WordPressie: instalacja krok po kroku

Jak dodać widżet dostępności EaseAccess24 do strony w WordPressie.

Woo Commerce cover banner

Jak zainstalować widżet dostępności EaseAccess24 w WooCommerce

Widżet dostępności EaseAccess24 w sklepie WooCommerce: instalacja krok po kroku.