CKTIS / HTML
headingoffset — desplazamiento de niveles de encabezado
El atributo global de HTML `headingoffset` aumenta los niveles de encabezado calculados. Acepta un entero de 0 a 8; los desplazamientos anidados se suman, mientras que `headingreset` establece un límite para el cálculo.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
headingoffset="N" (N: integer, 0–8)headingoffset es un atributo global de HTML que permite desplazar los niveles de encabezado dentro del contenido de un elemento. Su valor debe ser un entero válido no negativo entre 0 y 8, ambos incluidos. No es un atributo booleano: escribirlo sin valor no significa un desplazamiento de uno.
El cálculo comienza con el nivel que indica el nombre del encabezado: h1 significa 1 y h6 significa 6. Después se suman los desplazamientos del propio encabezado y de sus antecesores. Los valores anidados se acumulan; el nivel final tiene un máximo de 9. Si falta el atributo o no se puede analizar su valor, aporta 0. Al cruzar el límite de un shadow root, el cálculo continúa desde su host.
El atributo booleano headingreset detiene el recorrido hacia otros antecesores, pero solo después de incluir cualquier headingoffset del mismo elemento. Establecer únicamente headingoffset="0" no detiene la acumulación. Este mecanismo afecta al nivel semántico: no cambia el nombre del elemento y no debe tratarse como un ajuste del tamaño de fuente.
En el ejemplo, los niveles esperados son, en orden, 1, 2, 3, 1. El campo output describe el resultado algorítmico del estándar, no texto que la página imprima. Antes de implementarlo, comprueba el comportamiento de los navegadores y las tecnologías de asistencia que te interesen; que una función aparezca en el estándar no confirma que esté implementada.
Ejemplos
<!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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.