CKTIS / HTML
conceito HTML: document-outline
O esquema de um documento é a estrutura ordenada de títulos usada para navegação e índices; não é uma árvore automática de secções exposta por uma API DOM dedicada.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
headings in tree order + computed heading levelsA norma define o esquema como cada elemento h1, h2, h3, h4, h5 e h6 em ordem da árvore, interpretado pelo nível calculado. Se o documento tiver títulos, pelo menos um deve ter nível 1, e o título seguinte não pode descer mais de um nível.
Os elementos section, article, nav e aside dão significado de secção ao conteúdo, mas não alteram por si o nível do título. Os novos atributos headingoffset e headingreset participam no cálculo; verifica o suporte nos navegadores e ferramentas de acessibilidade de destino.
O elemento title não é um título do esquema e um contentor header não o altera por si. Não existe uma propriedade padrão document.outline; um script de índice tem de recolher títulos, preservar a ordem e criar ligações. O tamanho CSS não muda o nível semântico.
O exemplo recolhe h1, h2, h3, h4, h5 e h6 em ordem da árvore, mostra três títulos que são filhos diretos de secções e observa a ausência de document.outline. O resultado demonstra a estrutura fornecida pelo autor, não a apresentação de um leitor de ecrã específico.
Exemplos
<!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>
Resultado
outline=h1:Guide>h2:Start>h2:Finish>h3:Details; sections=h2,h2,h3; api=false
O exemplo executado confirma a ordem dos títulos e a ausência de um objeto de esquema; não prova como cada tecnologia de apoio apresenta essa estrutura.