WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

headingoffset — Verschiebung von Überschriftenebenen

Das globale HTML-Attribut `headingoffset` erhöht die berechneten Überschriftenebenen. Es akzeptiert eine ganze Zahl von 0 bis 8; verschachtelte Offsets werden addiert, während `headingreset` eine Grenze für die Offset-Berechnung setzt.

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

Syntax

headingoffset="N" (N: integer, 0–8)

headingoffset ist ein globales HTML-Attribut, mit dem Überschriftenebenen innerhalb des Inhalts eines Elements verschoben werden. Sein Wert muss eine gültige nicht negative Ganzzahl von 0 bis einschließlich 8 sein. Es ist kein boolesches Attribut: Ohne Wert bedeutet es nicht, dass der Offset eins beträgt.

Die Berechnung beginnt mit der Ebene, die sich aus dem Namen der Überschrift ergibt: h1 steht für 1 und h6 für 6. Danach werden die Offsets der Überschrift selbst und ihrer Vorfahren addiert. Verschachtelte Werte summieren sich; die endgültige Ebene ist auf 9 begrenzt. Ein fehlendes Attribut oder ein Wert, der nicht geparst werden kann, trägt 0 bei. Beim Überqueren einer Shadow-Root-Grenze wird die Berechnung beim Host fortgesetzt.

Das boolesche Attribut headingreset beendet das Durchlaufen weiterer Vorfahren, allerdings erst, nachdem ein headingoffset desselben Elements berücksichtigt wurde. headingoffset="0" allein beendet die Summierung nicht. Dieser Mechanismus betrifft die semantische Ebene – er benennt das Element nicht um und sollte nicht als Einstellung für die Schriftgröße behandelt werden.

Im Beispiel lauten die erwarteten Ebenen der Reihe nach 1, 2, 3, 1. Das Feld output beschreibt das algorithmische Ergebnis gemäß dem Standard und keinen von der Seite ausgegebenen Text. Prüfe vor dem Einsatz das Verhalten der Zielbrowser und unterstützenden Technologien; die Aufnahme in einen Standard bestätigt keine Implementierungsunterstützung.

Beispiele

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

Ergebnis

Guide: 1
Installation: 2
Requirements: 3
Independent heading: 1

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen