CKTIS / HTML
koncept HTML: document-outline
Osnova dokumentu je uspořádaná struktura nadpisů pro navigaci a obsahy; nejde o automaticky vytvořený strom oddílů zpřístupněný zvláštním API DOM.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
headings in tree order + computed heading levelsStandard definuje osnovu jako každý prvek h1, h2, h3, h4, h5 a h6 v pořadí stromu, vyložený podle vypočtené úrovně. Má-li dokument nadpisy, alespoň jeden by měl mít úroveň 1 a následující nesmí sestoupit o více než jednu úroveň.
Prvky section, article, nav a aside dávají obsahu význam oddílu, samy však nemění úroveň nadpisu. Novější atributy headingoffset a headingreset se účastní výpočtu; jejich podporu ověř v cílových prohlížečích a nástrojích přístupnosti.
Prvek title není nadpisem osnovy a kontejner header ji sám neovlivňuje. Standardní vlastnost document.outline neexistuje; skript pro obsah musí nadpisy sesbírat, zachovat pořadí a vytvořit odkazy. Velikost písma CSS nemění sémantickou úroveň.
Příklad sbírá h1, h2, h3, h4, h5 a h6 v pořadí stromu, ukazuje tři nadpisy, které jsou přímými dětmi oddílů, a pozoruje nepřítomnost document.outline. Výsledek dokládá strukturu autora, ne prezentaci konkrétní čtečky.
Pří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ýsledek
outline=h1:Guide>h2:Start>h2:Finish>h3:Details; sections=h2,h2,h3; api=false
Spuštěný příklad potvrzuje pořadí nadpisů a chybějící objekt osnovy; nedokazuje způsob prezentace každou asistivní technologií.