Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

headingoffset — posunutí úrovní nadpisů

Globální atribut HTML `headingoffset` zvyšuje vypočítané úrovně nadpisů. Přijímá celé číslo od 0 do 8; vnořené posuny se sčítají, zatímco `headingreset` stanoví hranici výpočtu posunu.

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

Syntaxe

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

headingoffset je globální atribut HTML, který posouvá úrovně nadpisů v obsahu prvku. Jeho hodnota musí být platné nezáporné celé číslo od 0 do 8 včetně. Nejde o booleovský atribut: zápis bez hodnoty neznamená posun o jedna.

Výpočet začíná úrovní vyplývající z názvu nadpisu: h1 znamená 1 a h6 znamená 6. Poté se přičtou posuny samotného nadpisu a jeho předků. Vnořené hodnoty se sčítají; výsledná úroveň je omezena na 9. Chybějící atribut nebo hodnota, kterou se nepodaří zpracovat, přispívá hodnotou 0. Při překročení hranice shadow root výpočet pokračuje od jeho hostitele.

Booleovský atribut headingreset zastaví procházení dalších předků, ale až poté, co se započítá případný headingoffset na stejném prvku. Samotné nastavení headingoffset="0" sčítání nezastaví. Tento mechanismus se týká sémantické úrovně: nemění název prvku a neměl by se chápat jako nastavení velikosti písma.

V příkladu jsou očekávané úrovně v pořadí 1, 2, 3, 1. Pole output popisuje algoritmický výsledek podle standardu, nikoli text vypsaný stránkou. Před nasazením ověřte chování cílových prohlížečů a asistivních technologií; uvedení ve standardu nepotvrzuje podporu v implementacích.

Příklady

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

Výsledek

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

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje