Kurs HTML i CSS · Moduł 10: Dostępność (a11y)
Semantyczny HTML a dostępność
W tej lekcji7
Wyobraź sobie niewidomego pielgrzyma, który wchodzi do świątyni, w której żadna komnata nie ma napisu nad wejściem. Słyszy echo kroków, ale nie wie, czy stoi w sali modlitw, czy w magazynie. Tak samo czuje się użytkownik czytnika ekranowego na stronie zbudowanej z samych <div>. W Starożytnym Egipcie hieroglify miały ściśle określone znaczenie - każdy symbol pełnił konkretną funkcję. Podobnie jest z semantycznym HTML: każdy znacznik niesie ze sobą informację o roli i znaczeniu treści, co jest kluczowe dla technologii wspomagających.
Dlaczego semantyka jest tak ważna?
Czytniki ekranowe (screen readers) nie "widzą" strony - odczytują jej strukturę HTML. Gdy używasz <div> do wszystkiego, czytnik nie wie, co jest nawigacją, co nagłówkiem, a co treścią główną. Porównaj dwie wersje tego samego fragmentu strony muzeum - najpierw "zupę z divów", potem wersję semantyczną:
<!-- ŹLE - "zupa z divów" -->
<div class="header">
<div class="nav">
<div class="nav-item">Strona główna</div>
<div class="nav-item">O nas</div>
</div>
</div>
<div class="content">
<div class="title">Witaj w muzeum</div>
<div class="text">Opis wystawy...</div>
</div>
<!-- DOBRZE - semantyczny HTML -->
<header>
<nav aria-label="Nawigacja główna">
<ul>
<li><a href="/">Strona główna</a></li>
<li><a href="/about">O nas</a></li>
</ul>
</nav>
</header>
<main>
<h1>Witaj w muzeum</h1>
<p>Opis wystawy...</p>
</main>Obie wersje mogą wyglądać identycznie, bo CSS potrafi upodobnić <div> do czegokolwiek. Różnica jest niewidoczna dla oka, ale ogromna dla czytnika: w drugiej wersji ogłosi on nawigację z listą dwóch linków, a użytkownik jednym skrótem klawiszowym przeskoczy do treści głównej. Treść się nie zmieniła - zmieniły się tylko znaczniki, a zwykłe napisy w menu stały się prawdziwymi linkami.
Kluczowe znaczniki semantyczne
Elementy sekcjonujące
Oto siedem znaczników, z których zbudujesz szkielet niemal każdej strony. Traktuj je jak napisy nad wejściami do komnat - każdy mówi, co znajduje się w środku:
<header> <!-- Nagłówek strony lub sekcji -->
<nav> <!-- Nawigacja -->
<main> <!-- Główna treść strony (tylko jeden na stronę!) -->
<article> <!-- Samodzielna treść (post, artykuł) -->
<section> <!-- Tematyczna grupa treści -->
<aside> <!-- Treść poboczna (sidebar) -->
<footer> <!-- Stopka strony lub sekcji -->Zwróć uwagę na komentarz przy <main>: strona ma dokładnie jeden widoczny element <main> (specyfikacja HTML dopuszcza kolejne tylko wtedy, gdy są ukryte atrybutem hidden). Inaczej jest z <header> i <footer> - mogą pojawić się wielokrotnie, na przykład w każdym <article> z osobna.
Hierarchia nagłówków
Nagłówki tworzą strukturę dokumentu. Czytniki ekranowe pozwalają nawigować po nagłówkach - w czytniku NVDA klawisz H przenosi do następnego - więc wielu użytkowników najpierw "przegląda" stronę samymi nagłówkami, jak pielgrzym czytający tylko tablice nad komnatami. Dlatego ich hierarchia musi być poprawna:
<!-- ŹLE - pominięty poziom h2 -->
<h1>Muzeum Egipskie</h1>
<h3>Wystawy stałe</h3> <!-- Powinno być h2! -->
<h4>Skarby faraonów</h4> <!-- Powinno być h3! -->
<!-- DOBRZE - poprawna hierarchia -->
<h1>Muzeum Egipskie</h1>
<h2>Wystawy stałe</h2>
<h3>Skarby faraonów</h3>
<h3>Mumie królewskie</h3>
<h2>Wystawy czasowe</h2>
<h3>Złoto Tutanchamona</h3>Poziom nagłówka oznacza miejsce w hierarchii, a nie wielkość liter. Jeśli <h2> wydaje Ci się za duży, zmniejsz go w CSS, ale nie przeskakuj do <h3> - czytnik uzna wtedy, że w dokumencie brakuje jednego poziomu. Kolejność jest zawsze ta sama: od <h1> (tytuł strony), przez <h2> i <h3>, aż do <h6>.
Listy
Listy też niosą znaczenie. Gdy linki nawigacji siedzą w <ul>, czytnik zapowie liczbę elementów, zanim użytkownik zacznie ich słuchać. Z kolei lista definicji <dl> łączy termin (<dt>) z objaśnieniem (<dd>), jak słownik skryby:
<!-- Nawigacja jako lista - czytnik powie "lista, 4 elementy" -->
<nav>
<ul>
<li><a href="/">Strona główna</a></li>
<li><a href="/exhibitions">Wystawy</a></li>
<li><a href="/tickets">Bilety</a></li>
<li><a href="/contact">Kontakt</a></li>
</ul>
</nav>
<!-- Lista definicji -->
<dl>
<dt>Skarabeusz</dt>
<dd>Święty żuk symbolizujący odrodzenie</dd>
<dt>Ankh</dt>
<dd>Symbol życia wiecznego</dd>
</dl>Punkty przy linkach usuniesz jedną regułą w CSS - wygląd to sprawa arkusza stylów, a znaczenie to sprawa HTML.
Landmark roles
Semantyczne znaczniki HTML automatycznie tworzą tzw. landmarks (punkty orientacyjne), po których użytkownicy czytników ekranowych mogą szybko nawigować:
| Znacznik HTML | Landmark Role | Opis |
|---|---|---|
<header> | banner | Nagłówek strony |
<nav> | navigation | Nawigacja |
<main> | main | Główna treść |
<aside> | complementary | Treść uzupełniająca |
<footer> | contentinfo | Stopka |
<section> | region* | Sekcja tematyczna |
<form> | form* | Formularz |
*Wymaga atrybutu aria-label lub aria-labelledby.
Tabela pokazuje też typową kolejność landmarków od góry strony: banner, navigation, main, complementary i contentinfo. Jest jeden niuans: <header> i <footer> dostają role banner i contentinfo tylko wtedy, gdy nie są zagnieżdżone w <article>, <aside>, <main>, <nav> ani <section>. Te role są wbudowane, więc nie dopisuj role="navigation" do <nav> - to powtórzenie tej samej informacji.
Praktyczny przykład
Połączmy wszystko w jedną stronę muzeum. Przeczytaj kod od góry do dołu i spróbuj wskazać każdy landmark z tabeli powyżej:
<!DOCTYPE html>
<html lang="pl">
<head>
<meta charset="UTF-8">
<title>Muzeum Starożytnego Egiptu</title>
</head>
<body>
<header>
<h1>Muzeum Starożytnego Egiptu</h1>
<nav aria-label="Nawigacja główna">
<ul>
<li><a href="/">Strona główna</a></li>
<li><a href="/exhibitions">Wystawy</a></li>
</ul>
</nav>
</header>
<main>
<article>
<h2>Wystawa: Skarby Tutanchamona</h2>
<p>Odkryj niesamowite artefakty...</p>
<figure>
<img src="mask.jpg" alt="Złota maska pośmiertna Tutanchamona">
<figcaption>Maska pośmiertna Tutanchamona, ok. 1323 p.n.e.</figcaption>
</figure>
</article>
</main>
<aside aria-label="Informacje dodatkowe">
<h2>Godziny otwarcia</h2>
<p>Pn-Pt: 9:00-17:00</p>
</aside>
<footer>
<p>Muzeum Starożytnego Egiptu 2024</p>
</footer>
</body>
</html>Nie ma tu ani jednego <div>, a niczego nie brakuje. <aside> dostał aria-label, więc czytnik przedstawi go jako "Informacje dodatkowe", a <figure> z <figcaption> wiąże zdjęcie maski z jego podpisem.
Typowe błędy semantyczne
Na koniec trzy pułapki, w które wpada prawie każdy początkujący. Każda para pokazuje wersję błędną i poprawną:
<!-- ŹLE: div zamiast button -->
<div onclick="submit()">Wyślij</div>
<!-- DOBRZE: natywny button -->
<button onclick="submit()">Wyślij</button>
<!-- ŹLE: span jako nagłówek -->
<span class="big-text">Ważny tytuł</span>
<!-- DOBRZE: właściwy nagłówek -->
<h2>Ważny tytuł</h2>
<!-- ŹLE: br do tworzenia odstępów -->
<br><br><br>
<!-- DOBRZE: CSS margin/padding -->
<p style="margin-top: 2rem;">Tekst z odstępem</p><div> z onclick nie dostanie focusu z klawiatury i nie zareaguje na Enter ani Spację, a natywny <button> robi to wszystko sam. <span> udający nagłówek nie pojawi się na liście nagłówków czytnika, a seria <br> to dla czytnika puste linie, nie odstęp. Zauważ, że żadna poprawna wersja nie potrzebuje ani jednego atrybutu ARIA. Moja rada: zanim sięgniesz po <div>, zapytaj, czy HTML nie ma już elementu o tym znaczeniu - najczęściej ma i to on jest najlepszym wyborem.
Walidacja semantyki
Możesz sprawdzić semantykę swojej strony za pomocą:
- W3C Validator - sprawdza poprawność HTML
- WAVE - analizuje dostępność strony
- Lighthouse - audyt dostępności w Chrome DevTools
Dokładniej poznasz je w lekcji o testowaniu dostępności, a w następnych lekcjach ten semantyczny szkielet stanie się podstawą nawigacji klawiaturowej.
Semantyczny HTML to fundament dostępności - tak jak solidne fundamenty piramidy zapewniają jej trwałość na tysiąclecia, tak poprawna semantyka zapewnia, że strona będzie dostępna dla wszystkich użytkowników. Każdy element HTML powinien odpowiadać swojej roli: nagłówek powinien być nagłówkiem, nawigacja nawigacją, a przycisk przyciskiem.
Praktyka
W edytorze poniżej znajdziesz semantyczną stronę muzeum. Zamień jeden ze znaczników na <div> i zastanów się, jaką informację stracił właśnie czytnik ekranowy:
Kod do tej lekcji: index.html
<!DOCTYPE html>
<html lang="pl">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Muzeum Starorzytnego Egiptu - Semantyczny HTML</title>
<link rel="stylesheet" href="style.css">
</head>
<body>
<header>
<h1>Muzeum Starorzytnego Egiptu</h1>
<nav aria-label="Nawigacja glowna">
<ul>
<li><a href="#exhibitions">Wystawy</a></li>
<li><a href="#artifacts">Artefakty</a></li>
<li><a href="#visit">Odwiedz nas</a></li>
</ul>
</nav>
</header>
<main>
<section id="exhibitions" aria-labelledby="ex-title">
<h2 id="ex-title">Aktualne wystawy</h2>
<article>
<h3>Skarby Tutanchamona</h3>
<p>Odkryj niezwykle artefakty z grobowca mlodego faraona,
odkrytego przez Howarda Cartera w 1922 roku.</p>
<figure>
<img src="https://placehold.co/400x250/d4af37/1a1a2e?text=Maska+Tutanchamona"
alt="Zlota maska posmiertna faraona Tutanchamona">
<figcaption>Maska posmiertna Tutanchamona, ok. 1323 p.n.e.</figcaption>
</figure>
</article>
<article>
<h3>Mumie Krolewskie</h3>
<p>Poznaj tajemnice mumifikacji w Starorzytnym Egipcie.</p>
</article>
</section>
<section id="artifacts" aria-labelledby="art-title">
<h2 id="art-title">Kolekcja artefaktow</h2>
<dl>
<dt>Skarabeusz</dt>
<dd>Swiety zuk symbolizujacy odrodzenie i stworzenie</dd>
<dt>Ankh</dt>
<dd>Symbol zycia wiecznego, nosznoy przez faraonow</dd>
<dt>Oko Horusa</dt>
<dd>Symbol ochrony, zdrowia i krolewskiej wladzy</dd>
</dl>
</section>
</main>
<aside aria-label="Informacje dodatkowe">
<h2>Godziny otwarcia</h2>
<p>Pn-Pt: 9:00-17:00</p>
<p>Sb-Nd: 10:00-18:00</p>
</aside>
<footer>
<p>Muzeum Starorzytnego Egiptu © 2024</p>
<nav aria-label="Linki stopki">
<ul>
<li><a href="/privacy">Polityka prywatnosci</a></li>
<li><a href="/accessibility">Deklaracja dostepnosci</a></li>
</ul>
</nav>
</footer>
</body>
</html>Pamiętaj: znacznik semantyczny to napis nad wejściem do komnaty - dzięki niemu każdy odwiedzający wie, dokąd prowadzi korytarz, nawet jeśli nie widzi ścian.
Hasła z dokumentacji w tej lekcji
Widzisz błąd w tej lekcji?
Sprawdź się
Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.
1. Ile elementów <main> może znajdować się na jednej stronie HTML?
2. Dlaczego poprawna hierarchia nagłówków (h1-h6) jest ważna dla dostępności?
Zadania praktyczne w grze
- Edytor kodu
Zamień divy na semantyczne znaczniki HTML: header, nav (z aria-label), main, article, aside i footer.
- Układanie w pionie
Ułóż nagłówki HTML od najważniejszego do najmniej ważnego: