CKTIS / HTML
headingoffset — отместване на нивата на заглавията
Глобалният HTML атрибут `headingoffset` повишава изчислените нива на заглавията. Приема цяло число от 0 до 8; вложените отмествания се събират, а `headingreset` задава граница за изчислението.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
headingoffset="N" (N: integer, 0–8)headingoffset е глобален HTML атрибут за отместване на нивата на заглавията в съдържанието на даден елемент. Стойността му трябва да е валидно неотрицателно цяло число от 0 до 8 включително. Това не е булев атрибут: записването му без стойност не означава отместване с едно.
Изчислението започва от нивото, зададено от името на заглавието: h1 означава 1, а h6 — 6. След това се събират отместванията на самото заглавие и на неговите предшественици. Вложените стойности се натрупват; крайното ниво е ограничено до 9. Липсващ атрибут или стойност, която не може да бъде обработена, допринася с 0. При преминаване през граница на shadow root изчислението продължава от неговия хост.
Булевият атрибут headingreset спира преминаването към следващи предшественици, но едва след като се включи евентуален headingoffset на същия елемент. Самото задаване на headingoffset="0" не спира натрупването. Механизмът засяга семантичното ниво: не преименува елемента и не бива да се приема за настройка на размера на шрифта.
В примера очакваните нива са последователно 1, 2, 3, 1. Полето output описва алгоритмичния резултат според стандарта, а не текст, изведен от страницата. Преди внедряване проверете поведението на целевите браузъри и помощните технологии; включването във стандарт не потвърждава поддръжка в реализациите.
Примери
<!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>Резултат
Guide: 1 Installation: 2 Requirements: 3 Independent heading: 1
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.