• Aplikacje webowe
  • HTML od podstaw - jak zbudować czytelną strukturę strony

HTML od podstaw - jak zbudować czytelną strukturę strony

Przemysław Kwiatkowski • 13 listopada 2026
Strona z podstawami html, oferująca wybór hostingu: taniego, dla sklepu, firmy lub bloga.

Spis treści

Otwierasz pusty plik, wpisujesz kilka zdań i zastanawiasz się, czemu przeglądarka nie widzi w nich nagłówka ani akapitu. HTML nadaje treści strukturę, ale sam znacznik nie zawsze wystarczy: znaczenie mają też jego rodzaj, położenie i atrybuty.

Wykres porównuje ładowanie skryptów w HTML: standardowy, defer i async. Podstawy HTML w praktyce.

HTML opisuje strukturę i znaczenie treści strony

  • Dokument składa się z deklaracji typu, sekcji metadanych i treści strony.
  • Znaczniki opisują rolę treści, a atrybuty uzupełniają je o dodatkowe informacje.
  • Elementy semantyczne pomagają nazwać części strony, na przykład nawigację i główną treść.
  • Przeglądarka może wyświetlić stronę mimo błędów, dlatego sam podgląd nie potwierdza poprawności kodu.

Poprawny szkielet dokumentu ułatwia dalszą pracę

Przeglądarka potrzebuje informacji, gdzie zaczyna się dokument, jakie ma metadane i która część zawiera treść widoczną na stronie. Taki układ przydaje się również w aplikacji .NET: widok Razor może generować HTML, ale nadal to HTML opisuje strukturę odpowiedzi wysyłanej do przeglądarki.



  
    
    
    Moja pierwsza strona
  
  
    

Cześć!

To jest treść strony.

</code> informuje przeglądarkę, że dokument ma być obsługiwany w nowoczesnym trybie. Atrybut lang="pl" określa język treści, a kodowanie UTF-8 pozwala prawidłowo zapisać polskie znaki. Bez tych elementów strona może się wyświetlać, ale jej obsługa przez narzędzia i użytkowników będzie mniej przewidywalna.

Sekcja zawiera informacje o dokumencie, na przykład tytuł karty, natomiast obejmuje treść strony. Wewnątrz

umieszcza się główną zawartość. To prosta mapa, do której później dochodzą style CSS i zachowanie JavaScriptu.

Znaczniki mówią przeglądarce, czym jest dana treść

Dwa fragmenty tekstu mogą wyglądać podobnie, a pełnić różne role.

oznacza główny nagłówek,

akapit, a odnośnik. Gdy oznaczysz tytuł zwykłym tekstem i powiększysz go dopiero CSS-em, wizualnie może przypominać nagłówek, ale w strukturze dokumentu nim nie będzie.

Atrybut zapisuje dodatkową informację w elemencie. W odnośniku href wskazuje cel, a w obrazie src lokalizuje plik. Tekst alternatywny w alt opisuje sens obrazu, jeśli jest informacyjny; przy grafice czysto dekoracyjnej zostawia się pusty atrybut alt="", by technologia asystująca nie odczytywała zbędnego opisu.

Dokumentacja API
Liczba żądań API w kolejnych miesiącach
  • Pierwszy punkt
  • Drugi punkt

Listę punktowaną zapisujesz przez

    , a uporządkowaną kolejność kroków przez
      . Tabela pasuje do danych, które rzeczywiście zestawiasz w wierszach i kolumnach, nie do układania całej strony. Wybieraj element według roli treści, bo wygląd najłatwiej zmienić później za pomocą CSS.

      Semantyczne elementy pomagają nazwać części strony

      W kodzie łatwo o pokusę, by opakować wszystko w

      . To neutralny kontener, więc sam nie wyjaśnia, czy zawiera menu, artykuł, czy główną treść; elementy takie jak ,
      i
      przekazują tę wskazówkę także narzędziom wspomagającym. MDN opisuje je jako elementy strukturalne, które pomagają rozpoznać funkcję obszaru strony.

      Praktyczna decyzja może wyglądać tak: jeśli fragment ma własny sens poza bieżącą stroną, rozważ

      ; jeśli grupuje temat w większej całości, użyj
      ; jeśli potrzebujesz tylko opakowania do stylowania, wybierz
      . Nawigację oznacz , a główny obszar treści
      . Nie dobieraj tych tagów do wyglądu, bo jego rolę przejmie CSS.

      Wyobraź sobie stronę panelu dla usługi w Azure z menu, wykresem użycia API i osobnymi kartami z logami. Menu można umieścić w

      , centralny widok w
      , a logi stanowiące samodzielne wpisy opisać jako
      ; pojedyncza karta użyta wyłącznie jako kontener może pozostać
      . Uważam, że taka prosta reguła jest lepszym startem niż próba użycia każdego semantycznego elementu na siłę.

      Strona może działać mimo błędnego HTML

      Brak znacznika zamykającego albo źle zagnieżdżone elementy nie zawsze kończą się pustym ekranem. Parser HTML stosuje określone reguły tworzenia drzewa dokumentu również wtedy, gdy napotka błędną składnię; WHATWG opisuje zarówno te reguły, jak i błędy, które powinny zgłaszać walidatory. To wyjaśnia, dlaczego strona może wyglądać „w porządku”, choć jej struktura różni się od zamierzonej.

      Widok w przeglądarce nie zastępuje kontroli kodu. Gdy element zostanie pominięty lub użyty w złej roli, przeglądarka może nadal coś wyświetlić, ale użytkownik klawiatury, czytnik ekranu lub skrypt aplikacji może otrzymać inną strukturę, niż zakładał autor. Poniższa tabela pomaga szybko rozpoznać, od czego zacząć poprawki.

      SytuacjaMożliwa przyczyna lub skutekCo zrobić
      Tytuł tylko wygląda jak nagłówekTekst nie ma semantyki nagłówkaOznacz go odpowiednim elementem

      –
      , a wygląd ustaw w CSS
      Menu jest grupą zwykłych kontenerówJego funkcja może nie wynikać ze strukturyUmieść linki nawigacyjne w
      Obraz z wykresem nie ma opisuOsoba, która go nie widzi, może stracić informacjęDodaj krótki opis danych do alt albo udostępnij równoważne dane w tekście
      Podgląd wygląda dobrze, ale walidator zgłasza błądPrzeglądarka mogła odtworzyć strukturę według reguł parseraPopraw zgłoszony błąd i ponownie sprawdź strukturę dokumentu

      Przy pierwszym projekcie sprawdzaj więc nie tylko to, czy tekst i obrazy się pojawiają. Obejrzyj strukturę nagłówków, role elementów oraz komunikaty walidatora, a w formularzu zwróć uwagę, czy kontrolki mają etykiety i czy przycisk wykonuje zamierzoną akcję.

      Pierwsza strona może być mała, ale czytelna

      Dobry start to pojedynczy plik z tytułem, jednym nagłówkiem, kilkoma akapitami, listą i linkiem. Gdy strona zacznie rosnąć, dodawaj elementy odpowiadające funkcji treści, a nie tylko jej aktualnemu wyglądowi. Wtedy CSS może zmienić układ bez przepisywania struktury, a kod pozostanie zrozumiały także wtedy, gdy widok generuje aplikacja .NET.

      FAQ - Najczęstsze pytania

      Zacznij od <!doctype html> i elementu <html lang="pl">. W <head> podaj między innymi kodowanie UTF-8, ustawienia widoku i tytuł strony, a w <body> umieść treść, na przykład wewnątrz <main>.

      Wybierz <article> dla fragmentu, który ma własny sens poza bieżącą stroną, a <section> dla grupy treści poświęconej tematowi w większej całości. Użyj <div>, gdy potrzebujesz neutralnego kontenera, na przykład do stylowania. Nawigację oznacz <nav>, a główną treść <main>.

      Dla obrazu niosącego informację podaj krótki opis jego sensu, na przykład alt="Liczba żądań API w kolejnych miesiącach" dla wykresu. Przy grafice czysto dekoracyjnej użyj alt="", aby technologia asystująca nie odczytywała zbędnego opisu.

      Parser HTML stosuje reguły tworzenia drzewa dokumentu także wtedy, gdy napotka błędną składnię, więc przeglądarka może wyświetlić stronę mimo błędu. Sam podgląd nie potwierdza poprawności kodu: sprawdź komunikaty walidatora i popraw zgłoszone błędy. Warto też skontrolować strukturę nagłówków i role elementów.

      Oceń artykuł

      Ocena: 0.00 Liczba głosów: 0

      Tagi

      html
      semantyka
      atrybuty
      walidacja
      Autor Przemysław Kwiatkowski
      Przemysław Kwiatkowski
      Jestem Przemysław i od 15 lat zajmuję się programowaniem .NET, chmurą Azure oraz sztuczną inteligencją. Moja przygoda z tymi technologiami zaczęła się od fascynacji możliwościami, jakie dają, a z czasem przerodziła się w pasję do tworzenia rozwiązań, które realnie wpływają na pracę i życie ludzi. Na kursdotnet.pl staram się dzielić się swoją wiedzą w sposób przystępny, tłumacząc złożone zagadnienia i pomagając zrozumieć, jak te dynamicznie rozwijające się obszary IT mogą być wykorzystane w praktyce. Dokładam wszelkich starań, aby prezentowane przeze mnie materiały były rzetelne, aktualne i oparte na sprawdzonych źródłach, a także aby uporządkować wiedzę w sposób ułatwiający jej przyswojenie.

      Udostępnij artykuł

      Napisz komentarz