Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

headingoffset — deslocamento dos níveis dos títulos

O atributo global de HTML `headingoffset` aumenta os níveis calculados dos títulos. Aceita um número inteiro de 0 a 8; os deslocamentos aninhados somam-se, enquanto `headingreset` estabelece um limite para o cálculo.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

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

headingoffset é um atributo global de HTML que permite deslocar os níveis dos títulos no conteúdo de um elemento. O seu valor tem de ser um número inteiro válido não negativo entre 0 e 8, inclusive. Não é um atributo booleano: escrevê-lo sem valor não significa um deslocamento de um.

O cálculo começa pelo nível indicado pelo nome do título: h1 significa 1 e h6 significa 6. Em seguida, somam-se os deslocamentos do próprio título e dos seus antepassados. Os valores aninhados acumulam-se; o nível final é limitado a 9. Um atributo em falta ou um valor cuja análise falhe contribui 0. Ao atravessar o limite de um shadow root, o cálculo continua a partir do respetivo host.

O atributo booleano headingreset interrompe a passagem para antepassados adicionais, mas só depois de incluir qualquer headingoffset existente nesse mesmo elemento. Definir apenas headingoffset="0" não interrompe a acumulação. Este mecanismo diz respeito ao nível semântico: não altera o nome do elemento e não deve ser tratado como uma definição do tamanho da letra.

No exemplo, os níveis esperados são, por ordem, 1, 2, 3, 1. O campo output descreve o resultado algorítmico do padrão, não texto apresentado pela página. Antes da implementação, verifica o comportamento dos browsers e das tecnologias de apoio visados; a inclusão no padrão não confirma o suporte da implementação.

Exemplos

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

Resultado

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes