Zum Artikel

Im Druckfenster können Sie auch als PDF speichern.

Prüfservice & Prüfsiegel

Wissen › Barrierefreiheit › Zeiger, Gesten und Zielgrößen

Stand 19. November 2026

Online: euid.com/wissen/barrierefreiheit/zeiger-gesten-zielgroessen/beschriftung-im-namen-sprachsteuerung

Prüfpunkt 2.5.3Stufe A

Warum muss die sichtbare Beschriftung im hinterlegten Namen vorkommen?

Die sichtbare Beschriftung eines Bedienelements muss in seinem hinterlegten, maschinenlesbaren Namen vorkommen, weil Sprachsteuerungs-Nutzer sprechen, was sie sehen: Wer „Klicke auf Senden“ sagt, erreicht die Schaltfläche nur, wenn deren hinterlegter Name das Wort „Senden“ enthält. Weicht der unsichtbare Name ab, läuft der Sprachbefehl ins Leere. Das WCAG-Kriterium 2.5.3 „Beschriftung im Namen“ verhindert genau dieses Auseinanderfallen.

Das W3C beschreibt den Fall: „Send“ auf dem Knopf, „submit“ im Code

Seit WCAG 2.1 vom Juni 2018 steht das Kriterium auf Stufe A. Das W3C erklärt es an einem Reporter mit Überlastungsschäden, der seinen Rechner per Sprache bedient. Die Software versteht fast alle Befehle, bis er zum Knopf „Send“ kommt. Er sagt „Send“, und nichts geschieht, denn im Code heißt der Knopf „submit“. Die Ursache liegt in der Rangfolge: aria-label und aria-labelledby, zwei Angaben im Quelltext, gehen dem sichtbaren Text vor und ersetzen ihn als Namen.

Wer zwei Namen für denselben Knopf kennen muss, arbeitet doppelt

Das W3C beschreibt die Folgen für zwei Gruppen. Wer per Sprache steuert, muss sich einen Befehl merken, der vom sichtbaren Text abweicht. Wer die Seite sieht und sie sich zugleich vorlesen lässt, hört andere Wörter, als auf dem Bildschirm stehen. Bei kognitiven Einschränkungen wiegt das besonders schwer. Stimmen beide Namen überein, trifft der Sprachbefehl den Knopf direkt, und der Fokus springt seltener überraschend an eine andere Stelle.

KI-Agenten suchen Knöpfe über denselben Namen

Agenten, die den Barrierefreiheitsbaum lesen, kennen einen Knopf unter seinem hinterlegten Namen. Playwright von Microsoft, die Grundlage des Werkzeugs Playwright MCP, zeigt jedes Element als Rolle und Name und empfiehlt, Elemente über genau diese beiden Angaben zu suchen.

Bittet ein Kunde seinen Assistenten, auf „Anfrage schicken“ zu klicken, und steht im Code „Absenden“, findet der Agent in der Liste keinen Knopf dieses Namens. Stimmt der Name mit dem sichtbaren Text überein, verstehen Mensch und Agent denselben Auftrag.

Sichtbarer Text und hinterlegter Name können auseinanderfallen

Jedes Bedienelement hat neben dem sichtbaren Text einen maschinenlesbaren Namen, den Vorleseprogramme und Sprachsteuerung verwenden. Normalerweise sind beide identisch. Auseinander fallen sie, wenn Entwickler den Namen im Quelltext gezielt überschreiben, oft in guter Absicht, um Vorleseprogrammen mehr Zusammenhang zu geben.

Ein Beispiel: Die Schaltfläche zeigt „Angebot anfordern“, der hinterlegte Name lautet „Kontaktformular öffnen“. Ein Sprachsteuerungs-Nutzer sagt „Klicke auf Angebot anfordern“ und nichts geschieht, denn ein Element dieses Namens existiert für die Software nicht. Die Regel ist einfach: Der hinterlegte Name darf ergänzen, muss aber den sichtbaren Wortlaut enthalten, am besten an erster Stelle.

So prüft der Prüfservice die Beschriftung im Namen

Die Messung sucht alle Links und Schaltflächen, deren Name im Quelltext überschrieben wurde, und vergleicht den sichtbaren Text mit dem hinterlegten Namen. Fehlt der sichtbare Wortlaut im Namen vollständig, gilt das Kriterium als noch offen. Der Bericht benennt das Element und beide Texte.

Grenzfälle behandelt die Messung vorsichtig: Sind die ersten Wörter der Beschriftung im Namen enthalten, nur der weitere Wortlaut weicht ab, vermerkt der Bericht einen manuellen Prüffall statt eines Befunds. Sehr kurze sichtbare Texte, die als Symbol wirken, etwa ein „X“ zum Schließen, sind laut Kriterium ausgenommen und werden nicht angelastet.

Beispiele

Hinterlegter Name ohne die sichtbare Beschriftung

Nicht erfüllt

<button aria-label="Absenden">Anfrage schicken</button>

Erfüllt

<button>Anfrage schicken</button>
<!-- oder: aria-label="Anfrage schicken an den Vertrieb" -->

Sprachsteuerung sagt „Klicke Anfrage schicken“. Der zugängliche Name muss den sichtbaren Text enthalten, am besten am Anfang.

So gehen Sie es an

  1. Bitten Sie Ihre Agentur, alle überschriebenen Namen im Quelltext aufzulisten und mit den sichtbaren Beschriftungen abzugleichen.
  2. Stellen Sie den sichtbaren Wortlaut an den Anfang des hinterlegten Namens; Ergänzungen folgen dahinter.
  3. Verzichten Sie auf überschriebene Namen, wo der sichtbare Text bereits alles sagt. Besser kein überschriebener Name als ein abweichender.
  4. Testen Sie stichprobenartig mit der Sprachsteuerung Ihres Telefons: Sagen Sie den sichtbaren Text einer Schaltfläche und prüfen Sie, ob sie reagiert.

Tipps aus der Praxis

  • Groß- und Kleinschreibung und die meisten Satzzeichen zählen nicht: Zu „Weiter…“ passt der Name „weiter“.
  • Schieben Sie keine versteckten Wörter in die Mitte. Aus „Preisliste herunterladen“ wird mit verstecktem Zusatz „Preisliste Österreich herunterladen“, und die gesprochene Wortfolge steht nicht mehr am Stück im Namen.
  • Zusatzwissen für Vorleseprogramme gehört in aria-describedby, die hinterlegte Beschreibung. Sie ändert den Namen nicht, und die Sprachsteuerung trifft weiter.

Häufige Fragen

Was ist der Accessible Name eines Bedienelements?
Der Accessible Name ist der maschinenlesbare Name, unter dem Hilfstechnik ein Element kennt: Vorleseprogramme sagen ihn an, Sprachsteuerung sucht Elemente darüber. Er entsteht normalerweise aus dem sichtbaren Text, kann im Quelltext aber überschrieben werden. Dann gilt: Der sichtbare Wortlaut muss im überschriebenen Namen enthalten bleiben, sonst laufen Sprachbefehle ins Leere.
Warum funktioniert meine Schaltfläche nicht per Sprachsteuerung?
Die häufigste Ursache: Der hinterlegte Name weicht vom sichtbaren Text ab. Die Sprachsteuerung sucht ein Element mit dem gesprochenen Wortlaut. Steht auf der Schaltfläche „Senden“, im Quelltext aber der Name „Formular abschicken“, findet sie nichts. Lassen Sie den überschriebenen Namen korrigieren, sodass er den sichtbaren Wortlaut enthält.
Wie prüft der Prüfservice dieses Kriterium automatisch?
Die Messung findet alle Links und Schaltflächen mit überschriebenem Namen und vergleicht sichtbaren Text und hinterlegten Namen direkt im Quelltext der geladenen Seite. Fehlt der sichtbare Wortlaut im Namen, meldet der Bericht einen Befund mit beiden Texten. Teilweise Übereinstimmungen werden als manueller Prüffall vermerkt, Symbol-Beschriftungen wie ein „X“ bleiben ausgenommen.

Wann hilft ein aria-label, und wann schadet es?

Ein aria-label hilft, wo ein Element keinen sichtbaren Text hat: beim Knopf mit einer Lupe oder bei zwei Menüs, die Namen brauchen. Es schadet, wo schon Text steht, denn es ersetzt ihn. aria-label ist ein Attribut im Quelltext, das einem Element einen Namen gibt, den nur Hilfstechnik liest. Steht auf dem Suchknopf „Los“ und im Attribut „Auf dieser Website suchen“, hört das Vorleseprogramm nur den zweiten Text, und ein Sprachbefehl mit „Los“ kann ins Leere laufen.

aria-label geht dem Text auf dem Knopf immer vor

Browser berechnen den Namen eines Elements nach einer festen Rangfolge, und aria-label steht über dem sichtbaren Text. Das W3C schreibt in seiner Anleitung: Bei Knöpfen und Links verbirgt das Attribut den Inhalt vor Hilfstechnik und setzt seinen Wert an dessen Stelle.

Gibt es schon eine sichtbare Beschriftung, soll aria-label deshalb vermieden oder nur mit Bedacht eingesetzt werden. Das Attribut ändert am Bildschirm nichts. Wer die Seite nur ansieht, bemerkt den Unterschied nie.

Was über vorhandenem Text schiefgeht

Die Sprachsteuerung sucht den Wortlaut, den der Mensch auf dem Bildschirm liest. Fehlt er im Namen, kann der Befehl den Knopf verfehlen. Auch die Pflege leidet: Das W3C warnt, dass Text, der nur im Quelltext steht, bei einer Änderung der Oberfläche leicht vergessen wird.

Heißt der Knopf nach dem Relaunch „Angebot anfordern“, kann das Attribut weiter „Kontakt“ sagen. Bei mehrsprachigen Seiten muss jedes aria-label eigens übersetzt werden; sonst hört der englische Besucher einen deutschen Namen. Absätze und Listenpunkte sollen laut W3C gar nicht auf diesem Weg benannt werden.

Wo aria-label gebraucht wird

Das W3C nennt den Fall ausdrücklich: Das Attribut ist nützlich, wo kein sichtbarer Text als Name taugt. Dazu gehört der Knopf, auf dem nur ein Kreuz oder eine Lupe zu sehen ist.

Dazu gehören auch Bereiche wie zwei Menüs auf einer Seite: Am nav-Element gibt das Attribut dem Menü einen Namen wie „Produkte“, und die Links darin bleiben hörbar, denn dort ersetzt es den Inhalt nicht. Über vorhandenem Text darf ein aria-label den Wortlaut ergänzen, wenn es ihn am Stück enthält, am besten am Anfang.

Zusatzwissen ohne Eingriff in den Namen

Soll ein Vorleseprogramm mehr sagen, als auf dem Knopf steht, ist aria-describedby der schonendere Weg. Dieses Attribut verweist auf einen anderen Text der Seite und liefert eine Beschreibung, die nach dem Namen angesagt wird. Der Name bleibt der sichtbare Wortlaut, und die Sprachsteuerung trifft weiter. Das W3C nennt diesen Weg für Überschriften, Anleitungen und Gruppenbeschriftungen.

Beispiele

Link mit abweichendem Namen

Nicht erfüllt

<a href="/preise" aria-label="Zu unseren Tarifen">Preise ansehen</a>

Erfüllt

<a href="/preise">Preise ansehen</a>
<!-- oder ergänzend: aria-label="Preise ansehen für alle Tarife" -->

Der sichtbare Wortlaut steht am Anfang des Namens. Die Sprachsteuerung findet „Preise ansehen“.

Tipps aus der Praxis

  • Suchen Sie im Quelltext nach aria-label und vergleichen Sie jeden Wert mit dem sichtbaren Text daneben. Sagen beide dasselbe, kann das Attribut weg.
  • Nehmen Sie aria-label in Ihre Übersetzungsliste auf. Die Werte stehen nicht auf der Oberfläche und fallen bei einer Sichtprobe der fremdsprachigen Seite nicht auf.

Häufige Fragen

Muss der Name genau dem sichtbaren Text entsprechen?
Er muss ihn enthalten, am besten am Anfang. Groß- und Kleinschreibung und die meisten Satzzeichen zählen dabei nicht.
Ist aria-labelledby die bessere Wahl?
Es verweist auf einen Text, der schon auf der Seite steht, und steht in der Rangfolge ganz oben. Damit überschreibt es einen sichtbaren Text genauso. Das W3C rät, es nur mit Sorgfalt als Ergänzung einzusetzen.

Quellen

  1. W3C: WCAG 2.2, Erfolgskriterium 2.5.3 Label in Name
    https://www.w3.org/TR/WCAG22/#label-in-name
  2. W3C: Understanding SC 2.5.3 Label in Name (Rangfolge, Satzzeichen, Klammern, wer profitiert)
    https://www.w3.org/WAI/WCAG22/Understanding/label-in-name.html
  3. W3C: Failure F96, Name ohne den sichtbaren Wortlaut, eingeschobene Wörter
    https://www.w3.org/WAI/WCAG22/Techniques/failures/F96
  4. W3C WAI: What's New in WCAG 2.1, Beispiel Send und submit
    https://www.w3.org/WAI/standards-guidelines/wcag/new-in-21/
  5. MDN Web Docs: Accessibility tree
    https://developer.mozilla.org/en-US/docs/Glossary/Accessibility_tree
  6. Microsoft: Playwright MCP, Arbeitsweise über den Barrierefreiheitsbaum
    https://github.com/microsoft/playwright-mcp
  7. Microsoft: Playwright, Aria snapshots (Rolle und Name je Element)
    https://playwright.dev/docs/aria-snapshots
  8. Microsoft: Playwright, Locators (Suche über Rolle und Name)
    https://playwright.dev/docs/locators
  9. W3C: ARIA Authoring Practices, Providing Accessible Names and Descriptions
    https://www.w3.org/WAI/ARIA/apg/practices/names-and-descriptions/

Fotos

  • Foto: unbekannt „Door plate, England, 1860-1910 Wellcome L0058362“, CC BY 4.0 (https://commons.wikimedia.org/wiki/File:Door_plate,_England,_1860-1910_Wellcome_L0058362.jpg)
  • Foto: Erkaha „Schriftpraeger fuer Praegebaender“, CC BY-SA 4.0 (https://commons.wikimedia.org/wiki/File:Schriftpraeger_fuer_Praegebaender.jpg)

Dieses Dokument gibt die Online-Fassung vom 19. November 2026 wieder. Ändern sich Norm, Rechtslage oder Werkzeuge, wird die Online-Fassung überarbeitet; sie steht unter euid.com/wissen/barrierefreiheit/zeiger-gesten-zielgroessen/beschriftung-im-namen-sprachsteuerung.