Diese Prüfflags steuern, wo Benutzer (und APIs) den Zweck des Felds nicht zuverlässig bestimmen können. Jedes interaktive Steuerelement benötigt einen zugänglichen Namen, normalerweise von einem zugehörigen sichtbaren Label, aria-labelledby, oder – nur wenn kein sichtbares Label vorhanden ist – aria-label.
Automatisierte Checks vergleichen jedes Formularsteuerelement mit WCAG-Labelregeln: Steuerelemente brauchen einen programmatisch bestimmbaren Namen, der dem entspricht, was sehende Nutzer sehen (oder eine bewusste Textalternative, wenn kein sichtbares Label möglich ist).
Der Report listet konkrete Elemente (z. B. Inputs ohne passendes Label oder doppelte IDs, die Label-Zuordnung brechen). Diese zuerst beheben, dann den Crawl erneut ausführen, um zu prüfen, ob die Warnung verschwindet.
Verwenden Sie diesen Eintrag im Report als Evidenz. Behandeln Sie ihn nicht als eigenständige Regel, es sei denn, der Seitenkontext stützt dieselbe Schlussfolgerung.
So interpretieren Sie es
Jedes Textfeld, Select, Textarea und Custom-Control hat entweder ein sichtbares <label> mit for/id, ein umschließendes <label>, aria-labelledby auf sichtbaren Text oder ein dokumentiertes aria-label, wenn kein sichtbares Label möglich ist.
Gruppen verwandter Felder nutzen fieldset und legend (oder ein gleichwertiges Gruppierungsmuster), damit die Beziehung klar ist.
Icon-only-Buttons haben einen zugänglichen Namen (visuell versteckter Text, aria-label oder aria-labelledby).
Muster
Wann verwenden
<label for="id"> + input id
Standard für Einzelfelder; am besten für Screenreader und Sprachsteuerung.
Umschließendes <label>
Einfaches Markup, wenn das Label genau ein Steuerelement umschließt.
aria-labelledby
Wenn sichtbarer Text anderswo auf der Seite das Feld benennt (muss Element-IDs referenzieren).
aria-label
Selten: kein sichtbarer Text; kurze Strings und mit echter Assistivtechnik testen.
Nein. Platzhalter verschwinden, wenn das Feld einen Wert hat, und werden in unterstützenden Technologien oft übersprungen oder sind schwer zu hören. Verwenden Sie eine dauerhaft sichtbare Bezeichnung oder einen gleichwertigen programmatischen Namen.
Wann ist das Aria-Label akzeptabel?
Verwenden Sie aria-label nur, wenn es keinen geeigneten sichtbaren Text zum Referenzieren gibt und das Hinzufügen von sichtbarem Text in einem dokumentierten, seltenen Fall das Design beschädigen würde – bevorzugen Sie sichtbare Beschriftungen für fast alle Formulare.