CKTIS / HTML
aria-labelledby — ein Name aus vorhandenen Elementen
`aria-labelledby` bildet einen zugänglichen Namen aus dem Text von Elementen, auf die Kennungen verweisen.
Version: WAI-ARIA 1.2
Syntax
<button aria-labelledby="verb topic">Download</button>Kennungen werden durch Leerzeichen getrennt; die Reihenfolge der Verweise bestimmt die Reihenfolge der Namensteile. Verwende stabile eindeutige Kennungen und tatsächliche Beschriftungen statt beliebiger langer Inhalte.
Ein gültiger Verweis hat Vorrang vor aria-label. Er ersetzt weder eine zusätzliche Beschreibung noch das Verhalten einer nativen Beschriftung: Ein Klick auf referenzierten Text fokussiert ein Eingabefeld nicht automatisch. Bevorzuge bei gewöhnlichen Feldern die native Beziehung zwischen Beschriftung und Bedienelement.
Im Beispiel steht report im DOM früher, doch die Verweisliste bildet Download report. Der Test des Barrierefreiheitsbaums bestätigt diese Reihenfolge und verwirft den Ersatznamen Fallback. Eine Änderung des Seitenlayouts erfordert keine geänderte Namensreihenfolge.
Beispiele
<!doctype html><meta charset="utf-8">
<span id="topic">report</span>
<button id="download" aria-label="Fallback" aria-labelledby="verb topic"><span id="verb">Download</span></button>
<output id="result"></output>
<script>
document.querySelector('#result').textContent = 'referenceOrder=' + document.querySelector('#download').getAttribute('aria-labelledby').split(' ').map(id => document.getElementById(id).textContent).join(' ');
</script>Ergebnis
referenceOrder=Download report
Geprüft wurden berechneter Name, Verweisreihenfolge und Vorrang vor der textlichen Beschriftung.