CKTIS / HTML
aria-label — ein zugänglicher Name als Text
`aria-label` gibt einem Element einen zugänglichen Namen, sofern seine Rolle eine vom Autor vergebene Benennung erlaubt.
Version: WAI-ARIA 1.2
Syntax
<button aria-label="Close notice">×</button>Gib einen kurzen lokalisierten Aktionsnamen an, beispielsweise Close notice für einen Schließen-Button. Das Attribut verleiht beliebigen Elementen keine Rolle. Wenn sichtbarer Text oder eine native Beschriftung möglich ist, ist dies meist vorzuziehen.
Der Name kann den Inhaltstext ersetzen. Nimm die sichtbare Beschriftung auf, damit Sprachsteuerung und Bildschirm übereinstimmen. Ein gültiges aria-labelledby hat Vorrang. Dies ist weder ein Tooltip noch eine Bedienanweisung oder Ereignisbehandlung.
Im Beispiel trägt der Symbolbutton den Namen Close notice; sein dekoratives Zeichen ist aus der Zugänglichkeit ausgenommen. Eine separate Funktion verbirgt die Meldung bei Aktivierung. Der Test bestätigt berechneten Namen und Schließen der Meldung; übersetze die Beschriftung zusammen mit der Oberfläche.
Beispiele
<!doctype html><meta charset="utf-8">
<p id="notice">Your settings were saved.</p>
<button id="close" aria-label="Close notice"><span aria-hidden="true">×</span></button>
<output id="result"></output>
<script>
document.querySelector('#close').addEventListener('click', () => { document.querySelector('#notice').hidden = true; });
document.querySelector('#close').click();
document.querySelector('#result').textContent = 'noticeHidden=' + document.querySelector('#notice').hidden;
</script>Ergebnis
noticeHidden=true
Geprüft wurden Name und Aktion des Buttons; ARIA allein schließt die Meldung nicht.