Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

pojęcie HTML: document-outline

Konspekt dokumentu to uporządkowana struktura nagłówków służąca nawigacji i tworzeniu spisów treści; nie jest automatycznym drzewem sekcji dostępnym przez osobne API DOM.

Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately

Składnia

headings in tree order + computed heading levels

Standard definiuje konspekt jako wszystkie elementy h1, h2, h3, h4, h5 i h6 w kolejności drzewa, interpretowane według obliczonego poziomu. Jeśli dokument ma nagłówki, co najmniej jeden powinien mieć poziom 1, a kolejny nagłówek nie może skoczyć o więcej niż jeden poziom w dół.

Elementy section, article, nav i aside nadają treści znaczenie sekcyjne, lecz same nie zmieniają rangi nagłówka. Nowe atrybuty headingoffset i headingreset uczestniczą w obliczaniu poziomu; ich obsługę trzeba sprawdzić w docelowych przeglądarkach i narzędziach dostępności.

Element title nie jest nagłówkiem konspektu, a kontener header sam go nie zmienia. Nie istnieje standardowa właściwość document.outline; skrypt budujący spis treści musi zebrać nagłówki, zachować ich kolejność i utworzyć odnośniki. Rozmiar ustawiony przez CSS nie zmienia poziomu semantycznego.

Przykład zbiera h1, h2, h3, h4, h5 i h6 w kolejności drzewa, pokazuje trzy nagłówki będące bezpośrednimi dziećmi sekcji oraz brak document.outline. Wynik demonstruje strukturę zapisaną przez autora, nie zachowanie konkretnego czytnika ekranu.

Przykłady

<!doctype html>
<meta charset="utf-8">
<main>
  <h1>Guide</h1>
  <section><h2>Start</h2></section>
  <section><h2>Finish</h2><h3>Details</h3></section>
</main>
<output id="result"></output>
<script>
const headings = Array.from(document.querySelectorAll("h1,h2,h3,h4,h5,h6"), heading => `${heading.localName}:${heading.textContent}`);
const sectionHeadings = Array.from(document.querySelectorAll("section > h1,section > h2,section > h3,section > h4,section > h5,section > h6"), heading => heading.localName);
result.textContent = `outline=${headings.join(">")}; sections=${sectionHeadings.join(",")}; api=${"outline" in document}`;
</script>

Wynik

outline=h1:Guide>h2:Start>h2:Finish>h3:Details; sections=h2,h2,h3; api=false

Wykonany przykład potwierdza kolejność nagłówków i brak obiektu konspektu; nie dowodzi sposobu prezentacji struktury przez każdą technologię asystującą.

Źródła