page-has-heading-one

Seite sollte eine Überschrift der ersten Ebene haben

manualKonfidenz: mediumSchweregrad: minoroperable

Prüft, dass die Seite mindestens eine Überschrift der ersten Ebene hat (<h1> oder role="heading" mit aria-level="1").

Anwendbarkeit. Gilt immer für jedes HTML-Dokument mit einem <body>-Element: „Hat die Seite eine h1?“ betrifft die ganze Seite und folgt damit dem Muster von bypass-blocks-present, das Dokument direkt zu bewerten. Nicht, solange ein modaler Dialog geöffnet ist: Der Rest der Seite ist dann inert, der Scan sieht also den Dialog, nicht die Seite. Ein Custom Element, dem seine ElementInternals die Rolle heading geben (this.attachInternals().role) und das die Ebene 1 hat (über sein aria-level-Attribut oder das ariaLevel seiner Internals), zählt als <h1>. Ein natives <hx> mit role="none" oder "presentation" ist weiterhin eine Überschrift, wenn es den Fokus erhalten kann oder ein globales ARIA-Attribut trägt, da Browser diese Rolle dann nach der Konfliktauflösung für präsentationale Rollen in WAI-ARIA ignorieren. Ein natives <hx> mit gültigem aria-level (einer positiven Ganzzahl) hat diese Ebene, wie Browser sie bereitstellen: <h2 aria-level="1"> ist eine Überschrift der Ebene eins und <h1 aria-level="2"> nicht, so wie heading-order sie liest.

Erwartung. Es gibt mindestens eine Überschrift der Ebene 1 (natives <h1> oder role="heading" mit aria-level="1"). Eine Seite ohne Überschrift der obersten Ebene bietet Personen, die mit assistiven Technologien über Überschriften navigieren, keinen klaren Einstiegspunkt.

Beispiele

pass

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

Es gibt eine Überschrift der ersten Ebene.

can't tell

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

Es gibt kein <h1> und kein role="heading" aria-level="1".

So prüfen Sie es

Wenn diese Regel nicht entscheiden kann, meldet sie cantTell und überlässt die Frage einer Person. Jede Frage, die sie stellen kann, steht hier unter ihrem Reason-Code, mit den Schritten, um sie zu beantworten. Ein Befund enthält dieselben Schritte in howToCheck, in der Sprache des Scans. Siehe Ausgabeschema.

`HEADING_ONE_MISSING`

Öffnen Sie die Seite und suchen Sie ihren Haupttitel (den Text, der sagt, was diese Seite ist).
Öffnen Sie den Bereich „Barrierefreiheit“ der Entwicklertools oder die Überschriftenliste eines Screenreaders und suchen Sie nach einer Überschrift der Ebene 1.
Gibt es keine, prüfen Sie, ob der Haupttitel überhaupt als Überschrift ausgezeichnet ist und auf welcher Ebene.

Bestanden. Die Seite hat eine Überschrift der Ebene 1, die ihren Hauptinhalt benennt.

Nicht bestanden. Keine Überschrift der Seite hat Ebene 1, sodass die Navigation über Überschriften keinen klaren Anfang hat (Best Practice, G141).

Quellcode ansehen