Kurs HTML i CSS · Moduł 11: Narzędzia deweloperskie

Walidatory HTML i CSS - Kontrola jakości piramidy

4 min czytania ·
W tej lekcji4

Przeglądarka jest bardzo wyrozumiała: gdy zapomnisz o atrybucie albo zrobisz literówkę w nazwie właściwości CSS, nie wyświetli żadnego błędu, tylko po cichu spróbuje zgadnąć, o co Ci chodziło. Strona "jakoś działa" - do czasu, aż w innej przeglądarce albo w czytniku ekranowym rozsypie się jak źle spasowane bloki. Faraonowie Egiptu nie budowali piramid bez planów i kontroli jakości. Każdy blok musiał być idealnie dopasowany. W web developmencie rolę "kontrolera jakości" pełnią walidatory - narzędzia sprawdzające poprawność kodu.

W3C Markup Validator

W3C Markup Validation Service (validator.w3.org) to oficjalne narzędzie organizacji W3C do sprawdzania poprawności kodu HTML. Możesz użyć go na trzy sposoby:

  • Validate by URI - wpisz adres strony internetowej
  • Validate by File Upload - prześlij plik HTML z dysku
  • Validate by Direct Input - wklej kod HTML bezpośrednio

Sprawdzanie przebiega zawsze tak samo: wchodzisz na validator.w3.org, podajesz adres, plik albo wklejony kod, klikasz przycisk Check, a potem analizujesz wyniki i poprawiasz błędy od góry listy - jeden błąd potrafi wywołać kilka kolejnych. Walidator dzieli komunikaty na błędy (Error), ostrzeżenia (Warning) i informacje (Info). Błędy naprawiaj zawsze, a resztę czytaj uważnie.

Typowe błędy wychwytywane przez walidator:

Najczęstszy błąd to obraz bez tekstu alternatywnego. Specyfikacja HTML wymaga atrybutu alt przy <img>, więc walidator zgłosi jego brak:

<!-- BŁĄD: Brak atrybutu alt na img -->
<img src="piramida.jpg">

<!-- POPRAWNIE: -->
<img src="piramida.jpg" alt="Wielka Piramida w Gizie">

Poprawka dodaje tylko atrybut - obraz, jego adres i wygląd strony się nie zmieniają. <img> to element pusty: nie ma znacznika zamykającego, więc kończysz go zwykłym >. Ukośnik przed nawiasem jest dozwolony, ale niczego nie zmienia, a walidator pokaże przy nim tylko informację.

Drugi przykład to niezamknięty akapit. Tu kryje się ciekawa pułapka - przyjrzyj się kodowi:

<!-- ŹLE: Niezamknięty znacznik -->
<p>Tekst paragrafu
<p>Kolejny paragraf</p>

<!-- POPRAWNIE: -->
<p>Tekst paragrafu</p>
<p>Kolejny paragraf</p>

Specyfikacja HTML pozwala pominąć </p>, gdy zaraz po akapicie zaczyna się kolejny <p> albo element blokowy, np. <div>. Walidator akurat tego nie zgłosi, a przeglądarka sama domknie akapit - Ty jednak tracisz kontrolę nad tym, gdzie się on kończy. Niezamknięty <div> czy <strong> walidator już wychwyci (komunikat "Unclosed element"), dlatego zamykaj każdy znacznik jawnie - i to polecam.

Trzeci błąd łatwo przeoczyć w długim pliku: ten sam identyfikator użyty dwa razy. Atrybut id musi być unikalny w całym dokumencie:

<!-- BŁĄD: Zduplikowane ID -->
<div id="header">Nagłówek</div>
<div id="header">Inny nagłówek</div>

<!-- POPRAWNIE: -->
<div id="header">Nagłówek</div>
<div id="subheader">Inny nagłówek</div>

To nie jest kosmetyka: <label for>, kotwice z # i aria-describedby wskazują element po id, więc przy duplikacie trafiają w pierwszy pasujący element. Klasa może się powtarzać, identyfikator nigdy.

Pamiętaj też, że walidator sprawdza zgodność ze specyfikacją HTML, a nie dostępność. Pole <input> bez etykiety jest dla niego poprawne - taki problem wyłapiesz Lighthouse'em lub axe, które poznałeś w module o dostępności.

W3C CSS Validator

Podobne narzędzie istnieje dla CSS (jigsaw.w3.org/css-validator/). Sprawdza:

  • Poprawność składni CSS
  • Błędy w nazwach właściwości
  • Nieprawidłowe wartości

Zobacz dwa klasyczne błędy - literówkę w nazwie właściwości i wartość, której CSS nie rozumie:

/* BŁĄD: Nieprawidłowa właściwość */
h1 {
  colr: red;     /* powinno być: color */
}

/* BŁĄD: Nieprawidłowa wartość */
p {
  font-size: duży;  /* powinno być np. 16px, 1rem */
}

/* POPRAWNIE: */
h1 {
  color: #8b6914;
  font-size: 2rem;
}

Przeglądarka nie pokaże tu żadnego komunikatu - po prostu zignoruje obie deklaracje, a Ty będziesz się zastanawiać, dlaczego nagłówek nie jest czerwony. W DevTools, w karcie Styles, taka deklaracja jest przekreślona i oznaczona ikoną ostrzeżenia, a walidator CSS wskaże ją z numerem linii.

DevTools jako walidator

Chrome DevTools też pokazuje błędy w kodzie:

  • Panel Console - wyświetla błędy JavaScript i ostrzeżenia
  • Panel Elements - podświetla problematyczne elementy
  • Panel Issues - zbiera ostrzeżenia, np. o polach formularza bez powiązanej etykiety
  • Lighthouse - kompleksowy audyt strony

Dobra praktyka to uruchomienie walidacji po każdej większej zmianie w kodzie - tak jak starożytni architekci sprawdzali każdy nowy poziom piramidy. Waliduj zawsze przed publikacją: strona bez błędów walidacji to jeden z warunków projektu końcowego tego modułu.

Praktyka

W edytorze poniżej znajdziesz stronę, która przechodzi walidację W3C. Wklej jej kod do walidatora, a potem celowo usuń jeden alt i sprawdź, co się zmieni:

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>Walidacja HTML i CSS</title>
    <link rel="stylesheet" href="style.css">
</head>
<body>
    <h1>Walidacja kodu HTML i CSS</h1>

    <section>
        <h2>Poprawny kod HTML</h2>
        <p>Ponizszy kod przeszedl walidacje W3C:</p>

        <article>
            <h3>Poprawna struktura</h3>
            <img src="https://placehold.co/300x200/d4af37/1a1a2e?text=Piramida"
                 alt="Wielka Piramida w Gizie o zachodzie slonca"
                 width="300" height="200">
            <p>Obraz z atrybutem <code>alt</code> i wymiarami.</p>
        </article>

        <article>
            <h3>Poprawny formularz</h3>
            <form>
                <label for="name">Imie:</label>
                <input type="text" id="name" name="name">

                <label for="email">Email:</label>
                <input type="email" id="email" name="email">
            </form>
        </article>
    </section>

    <section>
        <h2>Typowe bledy do unikania</h2>
        <ul>
            <li>Brak atrybutu <code>alt</code> na obrazach</li>
            <li>Niezamkniete znaczniki HTML</li>
            <li>Zduplikowane atrybuty <code>id</code></li>
            <li>Elementy blokowe wewnatrz inline</li>
            <li>Brak <code>&lt;!DOCTYPE html&gt;</code></li>
        </ul>
    </section>
</body>
</html>

Pamiętaj: walidator to nadzorca budowy, który obchodzi piramidę z miarką - im wcześniej wskaże krzywy blok, tym mniej trzeba będzie rozbierać.

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. Co to jest W3C Markup Validation Service?

Zadania praktyczne w grze

  • Edytor kodu

    Napraw 4 błędy walidacji: dodaj alt do img, zamknij paragraf, napraw zduplikowane id, dodaj label do inputa.

  • Układanie w pionie

    Uporządkuj kroki sprawdzania poprawności strony za pomocą W3C Validator:

  • Klikanie w kolejności

    Jak poprawnie zamknąć element img z atrybutem alt?

  1. Zadanie z kodemNaprawa błędów walidacji HTML
  2. PytanieW3C Validator
  3. Ułóż w kolejnościKroki walidacji strony
  4. Kliknij w kolejnościTypowe błędy HTML

Przydatne artykuły