Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

concept HTML: document-outline

Le plan d’un document est la structure ordonnée des titres utilisée pour la navigation et les tables des matières ; ce n’est pas un arbre de sections automatique exposé par une API DOM dédiée.

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

Syntaxe

headings in tree order + computed heading levels

Le standard définit le plan comme chaque élément h1, h2, h3, h4, h5 et h6 dans l’ordre de l’arbre, interprété selon le niveau calculé. Si le document possède des titres, au moins un devrait être de niveau 1, et le titre suivant ne doit pas descendre de plus d’un niveau.

Les éléments section, article, nav et aside donnent un sens de section au contenu, mais ne changent pas seuls le rang d’un titre. Les attributs récents headingoffset et headingreset participent au calcul ; vérifiez leur prise en charge dans les navigateurs et outils d’accessibilité visés.

L’élément title n’est pas un titre du plan et un conteneur header ne modifie pas lui-même le plan. Il n’existe pas de propriété standard document.outline ; un script de table des matières doit collecter les titres, préserver l’ordre et créer des liens. La taille CSS ne change pas le niveau sémantique.

L’exemple collecte h1, h2, h3, h4, h5 et h6 dans l’ordre de l’arbre, montre trois titres enfants directs de sections et constate l’absence de document.outline. Le résultat démontre la structure fournie par l’auteur, non la présentation d’un lecteur d’écran précis.

Exemples

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

Résultat

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

L’exemple exécuté vérifie l’ordre des titres et l’absence d’objet de plan ; il ne prouve pas la présentation de cette structure par chaque technologie d’assistance.

Sources