База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / HTML

HTML концепция: document-outline

Структурата на документа е подредбата на заглавията за навигация и съдържания; тя не е автоматично дърво от раздели, предоставено чрез отделен DOM API.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

headings in tree order + computed heading levels

Стандартът определя структурата като всеки елемент h1, h2, h3, h4, h5 и h6 в реда на дървото, тълкуван според изчисленото ниво. Ако документът има заглавия, поне едно трябва да е от ниво 1, а следващото не бива да слиза с повече от едно ниво.

Елементите section, article, nav и aside придават значение на раздел, но сами не променят ранга на заглавието. По-новите атрибути headingoffset и headingreset участват в изчислението; проверете поддръжката им в целевите браузъри и инструменти за достъпност.

Елементът title не е заглавие от структурата, а контейнерът header сам не ѝ влияе. Няма стандартно свойство document.outline; скрипт за съдържание трябва да събере заглавията, да запази реда и да създаде връзки. Размерът на шрифта в CSS не променя семантичното ниво.

Примерът събира h1, h2, h3, h4, h5 и h6 в реда на дървото, показва три заглавия, които са преки деца на раздели, и наблюдава липсата на document.outline. Резултатът показва структурата от автора, не представянето на определен екранен четец.

Примери

<!doctype html>
<meta charset="utf-8">
<main>
  <h1>Guide</h1>
  <section><h2>Start</h2></section>
  <section><h2>Finish</h2><h3>Details</h3></section>
</main>
<output id="result"></output>
<script>
const headings = Array.from(document.querySelectorAll("h1,h2,h3,h4,h5,h6"), heading => `${heading.localName}:${heading.textContent}`);
const sectionHeadings = Array.from(document.querySelectorAll("section > h1,section > h2,section > h3,section > h4,section > h5,section > h6"), heading => heading.localName);
result.textContent = `outline=${headings.join(">")}; sections=${sectionHeadings.join(",")}; api=${"outline" in document}`;
</script>

Резултат

outline=h1:Guide>h2:Start>h2:Finish>h3:Details; sections=h2,h2,h3; api=false

Изпълненият пример потвърждава реда на заглавията и липсата на обект за структура; не доказва как всяка помощна технология я представя.

Източници