# Name, Rolle, Wert: Bedienelemente richtig auszeichnen

Source: https://allyway.ai/de/glossary/name-rolle-wert

Name, Rolle, Wert ist das WCAG-Erfolgskriterium 4.1.2: Bei allen Bedienelementen lassen sich Name und Rolle programmatisch ermitteln, vom Nutzer änderbare Zustände, Eigenschaften und Werte programmatisch setzen, und Änderungen werden an Hilfstechnologien gemeldet. Es gehört zur Stufe A.

Name, Rolle, Wert ist die Regel, die Bedienelemente für Hilfstechnologien verständlich macht. Ein Screenreader muss wissen, wie ein Element heißt („Suche“), was es ist (Button, Kontrollkästchen, Menü) und in welchem Zustand es sich befindet (aktiviert, aufgeklappt, 3 von 5). Wird ein `div` nur optisch als Schalter gestaltet und verrät nichts davon, können ihn sehende Mausnutzer bedienen – alle anderen hören „anklickbar“ oder gar nichts.

## Was es bedeutet

[WCAG 4.1.2 Name, Rolle, Wert](https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html) ist ein Kriterium der Stufe A in [WCAG 2.2](https://allyway.ai/de/regulations/wcag-2-2). Für alle Bedienelemente – Formularelemente, Links und per Skript erzeugte Komponenten eingeschlossen – verlangt es:

| Teil | Bedeutung | Typische Quelle |
|---|---|---|
| Name | Die Beschriftung ist für Software lesbar | Sichtbarer Text, `<label>`, `aria-label`, `aria-labelledby` |
| Rolle | Um welche Art von Element es sich handelt | Natives Element (`<button>`, `<input>`) oder ARIA-Rolle |
| Zustand, Eigenschaft, Wert | Aktueller Status, den Nutzer ändern können | `checked`, `aria-expanded`, `aria-pressed`, Reglerwert |
| Benachrichtigung | Änderungen erreichen Hilfstechnologien | Natives Verhalten oder aktualisierte ARIA-Attribute |

Der Hinweis des W3C beruhigt: Das Kriterium richtet sich vor allem an alle, die eigene Komponenten bauen oder per Skript verändern. Standard-HTML-Elemente erfüllen es bereits, wenn sie gemäß Spezifikation eingesetzt werden. Schwierig wird es bei selbst gebauten Widgets – Schaltern, [Tabs](https://allyway.ai/de/glossary/barrierefreie-tabs), [Akkordeons](https://allyway.ai/de/glossary/barrierefreies-akkordeon) oder [Comboboxen](https://allyway.ai/de/glossary/barrierefreies-dropdown) aus `div` und `span`.

> **Note:** > **Zuerst natives HTML**
> Ein echtes `<button>` bringt Rolle, Tastaturbedienung und Fokus von selbst mit. Das W3C führt es als Fehler F59, ein `div` oder `span` per Skript zum Bedienelement zu machen, ohne seine Rolle offenzulegen.

Auf dieses Kriterium angewiesen sind Menschen, die [Screenreader](https://allyway.ai/de/glossary/screenreader), Bildschirmvergrößerung oder Spracherkennung nutzen. Wer per Sprache „Suche klicken“ sagt, erreicht den Button nur, wenn sein [zugänglicher Name](https://allyway.ai/de/glossary/zugaenglicher-name) wirklich „Suche“ lautet.

## Praxisbeispiele

```html title="Beispiel"
<!-- Eigener Schalter: Name, Rolle und Zustand sind offengelegt -->
<button type="button" aria-pressed="false" id="dunkelmodus">
  Dunkelmodus
</button>

<!-- Aufklapper: Der Zustand ändert sich mit jedem Klick -->
<button type="button" aria-expanded="false" aria-controls="faq-1">
  Versandkosten
</button>
<div id="faq-1" hidden>Ab 50 € versenden wir kostenlos.</div>
```

Das Skript schaltet `aria-pressed` oder `aria-expanded` gemeinsam mit der optischen Änderung um. Damit sind „Wert“ und „Benachrichtigung“ erfüllt: Der Screenreader sagt „Versandkosten, Schalter, reduziert“ und danach „erweitert“. Die passenden W3C-Techniken sind ARIA4 (eine Rolle) und ARIA5 (Zustands- und Eigenschaftsattribute) – die Grundlagen erklärt der Eintrag zu [ARIA](https://allyway.ai/de/glossary/aria).

**Do:** Do

Wo immer möglich native Elemente verwenden, jedem Bedienelement einen Namen geben, der zum sichtbaren Text passt, `aria-expanded`, `aria-pressed` oder `aria-checked` bei jeder Zustandsänderung aktualisieren und eigene Widgets vollständig per [Tastaturbedienung](https://allyway.ai/de/glossary/tastaturbedienung) nutzbar halten.

**Don't:** Don't

Buttons aus anklickbaren `div`-Elementen bauen, Icon-Buttons ohne Namen lassen (ein [leerer Button](https://allyway.ai/de/glossary/leerer-button)), einen „aktiviert“-Look zeigen, den der Code nie meldet, oder eine Rolle vergeben, ohne das versprochene Tastaturverhalten umzusetzen.

## So prüfen Sie Name, Rolle, Wert



## Häufige Fragen

Q: Was bedeutet Name, Rolle, Wert in den WCAG?
A: Es ist das Erfolgskriterium 4.1.2 der Stufe A. Jedes Bedienelement muss Hilfstechnologien mitteilen, wie es heißt, welche Art Element es ist und welchen Zustand oder Wert es hat – und Änderungen müssen gemeldet werden.

Q: Erfüllen Standard-HTML-Elemente 4.1.2 automatisch?
A: Ja, wenn sie gemäß Spezifikation verwendet werden. Ein `<button>` mit Text oder ein beschriftetes `<input type="checkbox">` legt Namen, Rolle und Zustand bereits offen. Das Kriterium betrifft vor allem eigene Komponenten.

Q: Brauche ich ARIA für Name, Rolle, Wert?
A: Nein. Natives HTML ist die erste Wahl. ARIA brauchen Sie, wenn Sie eine Komponente bauen, die HTML nicht anbietet, oder um einem Button einen Zustand wie `aria-expanded` zu geben.

Q: Welche Fehler sind bei Name, Rolle, Wert typisch?
A: Bedienelemente ohne programmatisch ermittelbaren Namen (F68), per Skript zu Bedienelementen gemachte `div`- oder `span`-Elemente ohne Rolle (F59), Textalternativen, die beim Bildwechsel nicht mitgeändert werden (F20), und mehrteilige Formularfelder mit nur einem Namen (F86).

Q: Was unterscheidet 4.1.2 vom zugänglichen Namen?
A: Der zugängliche Name ist ein Teil von 4.1.2. Das Kriterium verlangt zusätzlich die Rolle, den aktuellen Zustand und Wert sowie die Weitergabe von Änderungen an Hilfstechnologien.
