CKTIS / HTML
koncept HTML: document-outline
Oris dokumenta je urejena struktura naslovov za navigacijo in kazala; ni samodejno ustvarjeno drevo odsekov, izpostavljeno s posebnim API DOM.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
headings in tree order + computed heading levelsStandard opredeli oris kot vsak element h1, h2, h3, h4, h5 in h6 v drevesnem vrstnem redu, razložen po izračunani ravni. Če ima dokument naslove, naj ima vsaj eden raven 1, naslednji pa ne sme preskočiti navzdol za več kot eno raven.
Elementi section, article, nav in aside vsebini dajo pomen odseka, sami pa ne spremenijo ravni naslova. Novejša atributa headingoffset in headingreset sodelujeta pri izračunu; preveri podporo v ciljnih brskalnikih in orodjih za dostopnost.
Element title ni naslov orisa in vsebnik header sam ne vpliva nanj. Standardna lastnost document.outline ne obstaja; skript za kazalo mora zbrati naslove, ohraniti vrstni red in ustvariti povezave. Velikost pisave CSS ne spremeni pomenske ravni.
Primer zbere h1, h2, h3, h4, h5 in h6 v drevesnem vrstnem redu, pokaže tri naslove, ki so neposredni otroci odsekov, in opazi odsotnost document.outline. Rezultat dokazuje avtorjevo strukturo, ne prikaza določenega bralnika zaslona.
Primeri
<!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>
Rezultat
outline=h1:Guide>h2:Start>h2:Finish>h3:Details; sections=h2,h2,h3; api=false
Izvedeni primer potrdi vrstni red naslovov in odsotnost objekta orisa; ne dokazuje predstavitve te strukture v vsaki podporni tehnologiji.