KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

HTML-concept: document-outline

Een documentoutline is de geordende kopstructuur voor navigatie en inhoudsopgaven; het is geen automatisch gemaakte sectieboom die via een afzonderlijke DOM-API beschikbaar is.

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

Syntax

headings in tree order + computed heading levels

De standaard definieert de outline als elk element h1, h2, h3, h4, h5 en h6 in boomvolgorde, geïnterpreteerd volgens het berekende kopniveau. Heeft een document koppen, dan hoort minstens één niveau 1 te hebben en mag een volgende kop niet meer dan één niveau omlaag springen.

De elementen section, article, nav en aside geven inhoud sectiebetekenis, maar wijzigen op zichzelf geen koprang. De nieuwere attributen headingoffset en headingreset doen mee aan de berekening; controleer ondersteuning in doelbrowsers en toegankelijkheidshulpmiddelen.

Het element title is geen outlinekop en een container header beïnvloedt de outline niet zelf. Er is geen standaardeigenschap document.outline; een script voor een inhoudsopgave moet koppen verzamelen, volgorde bewaren en links maken. CSS-lettergrootte verandert het semantische niveau niet.

Het voorbeeld verzamelt h1, h2, h3, h4, h5 en h6 in boomvolgorde, toont drie koppen die directe kinderen van secties zijn en ziet dat document.outline ontbreekt. Het resultaat toont auteursstructuur, niet de presentatie van een bepaalde schermlezer.

Voorbeelden

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

Resultaat

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

Het uitgevoerde voorbeeld bevestigt kopvolgorde en het ontbreken van een outlineobject; het bewijst niet hoe elke hulptechnologie die structuur presenteert.

Bronnen