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.