Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

koncept HTML: document-outline

Oris dokumenta je urejena struktura naslovov za navigacijo in kazala; ni samodejno ustvarjeno drevo odsekov, izpostavljeno s posebnim API DOM.

Različica: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

headings in tree order + computed heading levels

Standard opredeli oris kot vsak element h1, h2, h3, h4, h5 in h6 v drevesnem vrstnem redu, razložen po izračunani ravni. Če ima dokument naslove, naj ima vsaj eden raven 1, naslednji pa ne sme preskočiti navzdol za več kot eno raven.

Elementi section, article, nav in aside vsebini dajo pomen odseka, sami pa ne spremenijo ravni naslova. Novejša atributa headingoffset in headingreset sodelujeta pri izračunu; preveri podporo v ciljnih brskalnikih in orodjih za dostopnost.

Element title ni naslov orisa in vsebnik header sam ne vpliva nanj. Standardna lastnost document.outline ne obstaja; skript za kazalo mora zbrati naslove, ohraniti vrstni red in ustvariti povezave. Velikost pisave CSS ne spremeni pomenske ravni.

Primer zbere h1, h2, h3, h4, h5 in h6 v drevesnem vrstnem redu, pokaže tri naslove, ki so neposredni otroci odsekov, in opazi odsotnost document.outline. Rezultat dokazuje avtorjevo strukturo, ne prikaza določenega bralnika zaslona.

Primeri

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

Rezultat

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

Izvedeni primer potrdi vrstni red naslovov in odsotnost objekta orisa; ne dokazuje predstavitve te strukture v vsaki podporni tehnologiji.

Viri