WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

aria-describedby — ergänzende Beschreibung eines Bedienelements

`aria-describedby` verknüpft ein Element mit einer Erläuterung, die seinen zugänglichen Namen ergänzt.

Version: WAI-ARIA 1.2

Syntax

<input aria-describedby="hint limit">

Gib durch Leerzeichen getrennte Kennungen vorhandener Elemente an. Deren Text bildet die Beschreibung in der Reihenfolge der Verweise. Halte den eigenen Namen des Bedienelements kurz und klar; die Erläuterung kann ein Format, eine Grenze oder einen Hinweis nennen.

Dies ersetzt weder die Beschriftung noch legt es Validierungsregeln fest. Eine komplexe Beschreibungsstruktur wird zu Text abgeflacht; behandle den Mechanismus daher nicht als Navigation durch einen interaktiven Hilfebereich. Zusätzliche Informationen sollen auch visuell zugänglich bleiben.

Das Beispielfeld hat die native Beschriftung Project code und zwei Erläuterungen. Der Test des Barrierefreiheitsbaums bestätigt einen getrennten Namen und eine zusammengesetzte Beschreibung. Maximum 8 characters erzwingt keine Längenbegrenzung: Diese Regel muss separat implementiert werden.

Beispiele

<!doctype html><meta charset="utf-8">
<label for="code">Project code</label><input id="code" aria-describedby="hint limit">
<p id="hint">Use letters.</p><p id="limit">Maximum 8 characters.</p>
<output id="result"></output>
<script>
const input = document.querySelector('#code');
input.focus();
document.querySelector('#result').textContent = 'label=' + input.labels[0].textContent + '; description=' + input.getAttribute('aria-describedby').split(' ').map(id => document.getElementById(id).textContent).join(' ');
</script>

Ergebnis

label=Project code; description=Use letters. Maximum 8 characters.

Geprüft wurden berechnete Beschreibung und Feldname, nicht nur vorhandene Kennungen im HTML.

Quellen