Kurs HTML i CSS · Moduł 10: Dostępność (a11y)

Semantyczny HTML a dostępność

6 min czytania ·
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 HTMLLandmark RoleOpis
<header>bannerNagłówek strony
<nav>navigationNawigacja
<main>mainGłówna treść
<aside>complementaryTreść uzupełniająca
<footer>contentinfoStopka
<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 &copy; 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. 1. Ile elementów <main> może znajdować się na jednej stronie HTML?

  2. 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:

  1. Zadanie z kodemSemantyczne znaczniki zamiast div
  2. PytanieRola znacznika main
  3. PytanieHierarchia nagłówków
  4. Ułóż w kolejnościHierarchia nagłówków HTML

Przydatne artykuły