Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

aria-labelledby — nazwa z istniejących elementów

`aria-labelledby` buduje nazwę dostępną z tekstu elementów wskazanych identyfikatorami.

Wersja: WAI-ARIA 1.2

Składnia

<button aria-labelledby="verb topic">Download</button>

Lista identyfikatorów jest rozdzielona spacjami, a kolejność odwołań wyznacza kolejność fragmentów nazwy. Stosuj stabilne, jednoznaczne identyfikatory i rzeczywiste etykiety, a nie przypadkową długą treść.

Poprawne odwołanie ma pierwszeństwo przed aria-label. Nie zastępuje dodatkowego opisu ani zachowania natywnej etykiety: kliknięcie tekstu nie zacznie automatycznie przenosić fokusu do pola. Dla zwykłych pól nadal preferuj natywną parę etykieta–kontrolka.

W przykładzie słowo report znajduje się wcześniej w DOM, ale lista odwołań buduje nazwę Download report. Test drzewa dostępności potwierdza tę kolejność i pominięcie zapasowej nazwy Fallback. Zmiana układu strony nie wymaga zmiany kolejności nazwy.

Przykłady

<!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>

Wynik

referenceOrder=Download report

Sprawdzono rzeczywiście obliczoną nazwę, kolejność odwołań oraz pierwszeństwo nad etykietą tekstową.

Źródła