Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

concepto HTML: document-outline

El esquema de un documento es la estructura ordenada de encabezados usada para navegación e índices; no es un árbol automático de secciones expuesto mediante una API DOM dedicada.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

headings in tree order + computed heading levels

El estándar define el esquema como cada elemento h1, h2, h3, h4, h5 y h6 en orden de árbol, interpretado por su nivel calculado. Si un documento tiene encabezados, al menos uno debería ser de nivel 1, y el siguiente no debe bajar más de un nivel de golpe.

Los elementos section, article, nav y aside aportan significado seccional, pero por sí solos no cambian el rango del encabezado. Los atributos recientes headingoffset y headingreset intervienen en el cálculo; compruebe su compatibilidad en navegadores y herramientas de accesibilidad de destino.

El elemento title no es un encabezado del esquema y un contenedor header no lo modifica por sí mismo. No existe una propiedad estándar document.outline; un script de índice debe recoger encabezados, conservar el orden y crear enlaces. El tamaño de fuente CSS no cambia el nivel semántico.

El ejemplo recoge h1, h2, h3, h4, h5 y h6 en orden de árbol, muestra tres encabezados que son hijos directos de secciones y observa la ausencia de document.outline. El resultado demuestra la estructura escrita por el autor, no la presentación de un lector de pantalla concreto.

Ejemplos

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

Resultado

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

El ejemplo ejecutado verifica el orden de encabezados y la ausencia de un objeto de esquema; no prueba cómo presenta la estructura cada tecnología de asistencia.

Fuentes