CKTIS / HTML
concetto HTML: document-outline
La struttura del documento è la sequenza ordinata dei titoli usata per navigazione e sommari; non è un albero di sezioni generato automaticamente ed esposto da un’API DOM dedicata.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
headings in tree order + computed heading levelsLo standard definisce la struttura come ogni elemento h1, h2, h3, h4, h5 e h6 in ordine d’albero, interpretato secondo il livello calcolato. Se il documento ha titoli, almeno uno dovrebbe avere livello 1 e il successivo non deve scendere di più di un livello.
Gli elementi section, article, nav e aside danno significato di sezione al contenuto ma non cambiano da soli il rango del titolo. I nuovi attributi headingoffset e headingreset partecipano al calcolo; verificane il supporto nei browser e negli strumenti di accessibilità di destinazione.
L’elemento title non è un titolo della struttura e un contenitore header non la modifica da solo. Non esiste una proprietà standard document.outline; uno script per il sommario deve raccogliere titoli, preservare l’ordine e creare collegamenti. La dimensione CSS non cambia il livello semantico.
L’esempio raccoglie h1, h2, h3, h4, h5 e h6 in ordine d’albero, mostra tre titoli figli diretti di sezioni e osserva l’assenza di document.outline. Il risultato dimostra la struttura dell’autore, non la presentazione di uno specifico lettore di schermo.
Esempi
<!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>
Risultato
outline=h1:Guide>h2:Start>h2:Finish>h3:Details; sections=h2,h2,h3; api=false
L’esempio eseguito verifica ordine dei titoli e assenza dell’oggetto struttura; non prova come ogni tecnologia assistiva presenta tale struttura.