page-has-heading-one

La página debería tener un encabezado de nivel uno

Comprueba que la página tenga al menos un encabezado de nivel uno (<h1> o role="heading" con aria-level="1").

Ámbito de aplicación. Aplicable a cualquier documento HTML con un elemento <body> que es una página propia (un documento mostrado en un frame no lo es): "¿tiene la página un h1?" es una cuestión de toda la página, siguiendo el mismo patrón que bypass-blocks-present de evaluar el documento directamente. No mientras haya un diálogo modal abierto: el resto de la página es inerte entonces, así que el análisis ve el diálogo, no la página. Un elemento personalizado cuyos ElementInternals le dan el rol heading (this.attachInternals().role) y el nivel 1 (su atributo aria-level o el ariaLevel de sus internals) cuenta como un <h1>. Un <hx> nativo marcado con role="none" o "presentation" sigue siendo un encabezado cuando puede recibir el foco o lleva un atributo ARIA global, ya que la resolución de conflictos de los roles presentacionales de WAI-ARIA hace que los navegadores ignoren ese rol en ese caso. Un <hx> nativo con un aria-level válido (un entero positivo) tiene ese nivel, como lo exponen los navegadores: <h2 aria-level="1"> es un encabezado de nivel uno y <h1 aria-level="2"> no lo es, igual que los lee heading-order.

Resultado esperado. Existe al menos un encabezado de nivel 1 (<h1> nativo, o role="heading" con aria-level="1"). Una página sin encabezado de nivel superior no tiene un punto de entrada claro para los usuarios de tecnología de asistencia que navegan por encabezados.

Ejemplos

<body>
  <h1>Page title</h1>
</body>

<body>
  <h2>Section</h2>
  <p>No top-level heading anywhere on the page.</p>
</body>

Cómo comprobarlo

Cuando esta regla no puede decidir, informa cantTell y deja la pregunta a una persona. Cada pregunta que puede plantear aparece aquí bajo su código de motivo, con los pasos para responderla. Un hallazgo lleva los mismos pasos en howToCheck, en el idioma del análisis. Consulta Esquema de salida.

Ver código fuente