Attribut HTML universel : headingreset

Valeurs

C'est un attribut booléen ; il prend effet lorsqu'il est présent. Une valeur pour cet attribut est ignorée, donc headingreset, headingreset="" et headingreset="false" ont tous le même effet.

Description

Lorsque le navigateur calcule le niveau de titre d'un élément de titre, il remonte la chaîne des éléments ancêtres et additionne les valeurs de headingoffset qu'il trouve. L'attribut headingreset arrête cette remontée : les décalages définis sur l'élément lui-même sont toujours pris en compte, mais aucun ancêtre au-dessus de celui-ci ne contribue à un décalage.

Utilisez cet attribut pour le contenu qui ne fait pas partie de la structure du document environnant, comme une fenêtre de dialogue (<dialog>), une info-bulle ou du balisage inséré depuis une autre source. Leurs titres prennent alors le niveau de leur nom d'élément.

Si l'élément possède à la fois headingoffset et headingreset, son propre décalage s'applique et tout ce qui est au-dessus est ignoré.

Exemples

Réinitialiser les niveaux de titre dans une fenêtre de dialogue

Dans cet exemple, la <section> décale ses titres de 2, donc le titre directement à l'intérieur est au niveau 3. L'élément <dialog> a headingreset, donc le décalage de la section n'atteint jamais le titre à l'intérieur du dialogue, qui reste au niveau 1 :

<section headingoffset="2">
  <h1>Niveau 3</h1>

  <dialog headingreset>
    <h1>Niveau 1</h1>
    <p>Le décalage de la section ne s'applique pas ici.</p>
  </dialog>
</section>

Utiliser headingreset et headingoffset sur le même élément

Dans cet exemple, le décalage externe de 3 n'atteint jamais le titre. Seul le décalage sur l'élément avec headingreset s'applique, donc le titre est au niveau 2 :

<div headingoffset="3">
  <div headingreset headingoffset="1">
    <h1>Niveau 2</h1>
  </div>
</div>

Spécifications

Compatibilité des navigateurs

Voir aussi

• L'attribut universel headingoffset
• Les éléments <h1>—<h6>
• L'attribut ARIA aria-level