Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

headingoffset — przesunięcie poziomów nagłówków

Globalny atrybut HTML `headingoffset` zwiększa obliczane poziomy nagłówków. Przyjmuje liczbę całkowitą od 0 do 8; zagnieżdżone przesunięcia sumują się, a `headingreset` wyznacza granicę ich obliczania.

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

Składnia

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

headingoffset jest globalnym atrybutem HTML służącym do przesuwania poziomów nagłówków w zawartości elementu. Jego wartość musi być poprawną nieujemną liczbą całkowitą od 0 do 8 włącznie. Nie jest atrybutem logicznym: zapis bez wartości nie oznacza przesunięcia o jeden.

Obliczanie rozpoczyna się od poziomu wynikającego z nazwy nagłówka: h1 oznacza 1, a h6 oznacza 6. Następnie dodaje się przesunięcia z samego nagłówka i jego przodków. Zagnieżdżone wartości sumują się; końcowy poziom nie przekracza 9. Brak atrybutu lub błąd parsowania jego wartości wnosi 0. Przy przejściu przez granicę shadow root obliczanie jest kontynuowane od hosta.

Logiczny atrybut headingreset zatrzymuje przechodzenie do dalszych przodków, ale dopiero po uwzględnieniu headingoffset na tym samym elemencie. Samo headingoffset="0" nie zatrzymuje sumowania. Mechanizm dotyczy poziomu semantycznego — nie zmienia nazwy elementu; nie należy traktować go jako ustawienia rozmiaru czcionki.

W przykładzie oczekiwane poziomy to kolejno 1, 2, 3, 1. Pole output opisuje wynik algorytmu standardu, a nie tekst wypisywany przez stronę. Przed użyciem sprawdź zachowanie docelowych przeglądarek i technologii asystujących; obecność funkcji w standardzie nie stanowi potwierdzenia obsługi.

Przykłady

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

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła