CKTIS / HTML
headingoffset — décalage des niveaux de titre
L’attribut HTML global `headingoffset` augmente les niveaux de titre calculés. Il accepte un entier de 0 à 8 ; les décalages imbriqués s’additionnent, tandis que `headingreset` établit une limite au calcul des décalages.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
headingoffset="N" (N: integer, 0–8)headingoffset est un attribut HTML global qui permet de décaler les niveaux de titre dans le contenu d’un élément. Sa valeur doit être un entier valide non négatif compris entre 0 et 8 inclus. Ce n’est pas un attribut booléen : le laisser sans valeur ne signifie pas un décalage de un.
Le calcul commence par le niveau indiqué par le nom du titre : h1 signifie 1 et h6 signifie 6. On ajoute ensuite les décalages du titre lui-même et de ses ancêtres. Les valeurs imbriquées se cumulent ; le niveau final est plafonné à 9. Un attribut absent ou une valeur dont l’analyse échoue contribue 0. Lorsqu’on franchit une limite de shadow root, le calcul continue à partir de son hôte.
L’attribut booléen headingreset arrête le parcours des ancêtres supplémentaires, mais seulement après la prise en compte de tout headingoffset présent sur ce même élément. Définir simplement headingoffset="0" n’interrompt pas le cumul. Ce mécanisme concerne le niveau sémantique : il ne renomme pas l’élément et ne doit pas être considéré comme un réglage de taille de police.
Dans l’exemple, les niveaux attendus sont, dans l’ordre, 1, 2, 3, 1. Le champ output décrit le résultat algorithmique défini par le standard, et non un texte affiché par la page. Avant le déploiement, vérifiez le comportement des navigateurs et technologies d’assistance ciblés ; la présence dans un standard ne confirme pas la prise en charge de l’implémentation.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Heading offsets</title>
<body>
<h1>Guide</h1>
<section headingoffset="1">
<h1>Installation</h1>
<section headingoffset="1">
<h1>Requirements</h1>
<div headingreset>
<h1>Independent heading</h1>
</div>
</section>
</section>
</body>
</html>Résultat
Guide: 1 Installation: 2 Requirements: 3 Independent heading: 1
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.