Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / HTML

koncept HTML: document-outline

Osnova dokumentu je usporiadaná štruktúra nadpisov pre navigáciu a obsahy; nejde o automaticky vytvorený strom oddielov sprístupnený osobitným API DOM.

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

Syntax

headings in tree order + computed heading levels

Štandard definuje osnovu ako každý prvok h1, h2, h3, h4, h5 a h6 v poradí stromu, vyložený podľa vypočítanej úrovne. Ak má dokument nadpisy, aspoň jeden by mal mať úroveň 1 a nasledujúci nesmie zostúpiť o viac než jednu úroveň.

Prvky section, article, nav a aside dávajú obsahu význam oddielu, samy však nemenia úroveň nadpisu. Novšie atribúty headingoffset a headingreset sa zúčastňujú výpočtu; ich podporu over v cieľových prehliadačoch a nástrojoch prístupnosti.

Prvok title nie je nadpisom osnovy a kontajner header ju sám neovplyvňuje. Štandardná vlastnosť document.outline neexistuje; skript pre obsah musí nadpisy zozbierať, zachovať poradie a vytvoriť odkazy. Veľkosť písma CSS nemení sémantickú úroveň.

Príklad zbiera h1, h2, h3, h4, h5 a h6 v poradí stromu, ukazuje tri nadpisy, ktoré sú priamymi deťmi oddielov, a pozoruje neprítomnosť document.outline. Výsledok dokladá štruktúru autora, nie prezentáciu konkrétnej čítačky.

Príklady

<!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>

Výsledok

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

Spustený príklad potvrdzuje poradie nadpisov a chýbajúci objekt osnovy; nedokazuje spôsob prezentácie každou asistenčnou technológiou.

Zdroje