Na stronie produktu masz kilka cech, które chcesz pokazać w punktach, i instrukcję, którą trzeba wykonać po kolei. W HTML zwykle użyjesz do tego odpowiednio listy nieuporządkowanej albo uporządkowanej, ale przy parach nazw i opisów lepszy będzie inny znacznik.
Znaczenie treści podpowiada, którego znacznika użyć
- umieszczaj wewnątrz listy; listę zagnieżdżoną wkładaj do elementu nadrzędnego.
- CSS odpowiada za wygląd, a HTML za strukturę i znaczenie treści.

Test zmiany kolejności rozstrzyga między a
Wyobraź sobie, że przestawiasz dwa sąsiednie punkty. Jeśli treść nadal znaczy to samo, pasuje . Jeśli zmiana kolejności zmienia instrukcję, ranking albo wynik, wybierz
. Ten prosty test jest praktyczniejszy niż decyzja podjęta wyłącznie na podstawie tego, czy w projekcie podobają Ci się kropki, czy cyfry.
Lista zakupów z produktami w dowolnej kolejności może wyglądać tak:
- Mleko
- Chleb
- Jabłka
Przepis wymaga innego rozwiązania, bo kolejność kroków prowadzi do określonego rezultatu:
- Rozgrzej piekarnik.
- Wymieszaj składniki.
- Przelej ciasto do formy.
Wybór nie wynika z dekoracji. Zasada opisana przez MDN sprowadza się do pytania, czy przestawienie elementów zmienia ich znaczenie; gdy tak się dzieje, lista powinna być uporządkowana. Tę samą semantykę odczytuje także technologia asystująca, więc forma listy jest częścią informacji, a nie samym formatowaniem.
Lista czy pary pojęć? Dla nazw i opisów użyj
Gdy każdy element ma postać „termin, a obok jego objaśnienie”, wypunktowanie może sugerować relację, której w treści nie ma. W takim przypadku sprawdzi się lista opisowa : termin oznacza się przez
, a jego opis przez .
- HTML
- Język znaczników opisujący strukturę strony.
- CSS
- Język używany do określania wyglądu strony.
Podobny układ przyda się w bloku parametrów produktu, na przykład „Materiał – bawełna” i „Kolor – granatowy”, jeśli chcesz przedstawić powiązane pary, a nie luźny zbiór punktów. nie służy wyłącznie do słowniczków
; jego sens polega na powiązaniu terminów i odpowiadających im opisów lub wartości. W polskich materiałach o dostępności cyfrowej serwisu gov.pl znajdziesz rozróżnienie tych trzech typów list i ich znaczników.
Zagnieżdżona lista musi należeć do konkretnego punktu
Podlista bezpośrednio pod znacznikiem albo wygląda w kodzie jak osobny element bez właściciela. Żeby zachować poprawną strukturę, umieść ją wewnątrz
- Odzież
- Koszulki
- Bluzy
- Akcesoria
Hierarchia w kodzie powinna odpowiadać hierarchii w treści. Podlista obejmująca „Koszulki” i „Bluzy” jasno pokazuje, że obie pozycje należą do kategorii „Odzież”, a nie stoją obok niej na tym samym poziomie. Nie twórz poziomów zagnieżdżenia tylko dla efektu wizualnego, bo każdy kolejny poziom powinien oznaczać rzeczywistą zależność.
Znaczniki listy mówią więcej niż widoczne kropki i numery
Dwa fragmenty mogą wyglądać podobnie, a jednak przekazywać inną strukturę. Wypisanie punktów jako kilku akapitów z ręcznie wstawionymi myślnikami nie tworzy semantycznej listy HTML. Z kolei prawidłowe lub grupuje elementy w sposób, który może rozpoznać czytnik ekranu i inne narzędzia. Tę praktykę opisuje technika dostępności W3C WAI H48.
Uważam, że semantyka powinna być pierwszym krokiem, a stylowanie drugim: najpierw dobierz element do relacji między treściami, potem dopasuj wygląd w CSS. Dzięki temu zmiana kroju punktorów albo odstępów nie zmienia sensu dokumentu.
| Sytuacja | Prawdopodobny problem | Co zrobić |
|---|---|---|
| Instrukcja jest oznaczona przez |
Numeracja etapów i ich kolejność mogą być istotne, ale kod tego nie komunikuje. | Sprawdź, czy zmiana kolejności zmienia wynik. Jeśli tak, użyj
|
| Lista punktów powstała przez ręcznie wpisane myślniki | Wygląda jak lista, lecz nie jest oznaczona jako grupa elementów listy. | Użyj
|
Podlista jest bezpośrednio wewnątrz
|
Brakuje elementu nadrzędnego, do którego należą jej pozycje. | Przenieś podlistę do właściwego |
| Każdy punkt zawiera nazwę i objaśnienie | Zwykłe wypunktowanie może zacierać relację między nazwą a opisem. | Rozważ
|
Numerację i wygląd ustawiaj bez psucia struktury
Lista uporządkowana może przydać się także wtedy, gdy numeracja ma kontynuować wcześniejszy fragment. Atrybut start pozwala określić numer początkowy, a reversed odwraca kolejność numerowania. Z kolei value w elemencie pozwala wskazać numer konkretnej pozycji, od którego zależą kolejne. Te możliwości opisuje dokumentacja elementu MDN dla
.
Przykład z numeracją rozpoczynającą się od czwartego kroku:
- Dodaj składniki do miski.
- Wymieszaj całość.
Wygląd punktorów, numerów i wcięć ustawisz w CSS, na przykład właściwością list-style-type. Nie wybieraj elementu HTML tylko po tym, jak ma wyglądać: najpierw odpowiedz, czy pozycje tworzą sekwencję, zbiór czy pary pojęć. Wtedy projekt może zmieniać styl, nie gubiąc znaczenia.
Dobra lista zaczyna się od relacji między elementami
Przed zapisaniem znaczników sprawdź, co łączy pozycje: kolejność, wspólna kategoria czy relacja terminu do opisu. ,
i
odpowiadają na różne potrzeby, a utrzymuje czytelną strukturę list punktowanych i numerowanych. Gdy kod odzwierciedla sens treści, wygląd można dopracować bez udawania listy samymi znakami tekstowymi.