Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

headingoffset — spostamento dei livelli delle intestazioni

L’attributo HTML globale `headingoffset` aumenta i livelli calcolati delle intestazioni. Accetta un intero da 0 a 8; gli spostamenti annidati si sommano, mentre `headingreset` stabilisce un limite per il calcolo.

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

Sintassi

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

headingoffset è un attributo HTML globale che consente di spostare i livelli delle intestazioni nel contenuto di un elemento. Il valore deve essere un intero valido non negativo compreso tra 0 e 8, inclusi. Non è un attributo booleano: scriverlo senza valore non significa applicare uno spostamento di uno.

Il calcolo parte dal livello indicato dal nome dell’intestazione: h1 significa 1 e h6 significa 6. Si sommano poi gli spostamenti dell’intestazione stessa e dei suoi antenati. I valori annidati si accumulano; il livello finale è limitato a 9. Un attributo assente o un valore che non può essere analizzato contribuisce 0. Quando si attraversa il confine di uno shadow root, il calcolo prosegue dal relativo host.

L’attributo booleano headingreset interrompe il passaggio agli antenati successivi, ma solo dopo aver incluso l’eventuale headingoffset presente sullo stesso elemento. Impostare soltanto headingoffset="0" non interrompe l’accumulo. Questo meccanismo riguarda il livello semantico: non rinomina l’elemento e non va considerato un’impostazione della dimensione del carattere.

Nell’esempio, i livelli previsti sono, nell’ordine, 1, 2, 3, 1. Il campo output descrive il risultato algoritmico dello standard, non il testo prodotto dalla pagina. Prima della distribuzione, verifica il comportamento dei browser e delle tecnologie assistive di destinazione; la presenza nello standard non conferma che la funzionalità sia implementata.

Esempi

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

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti