CKTIS / HTML
aria-labelledby — naziv iz postojećih elemenata
`aria-labelledby` sastavlja pristupačni naziv iz teksta elemenata navedenih identifikatorima.
Verzija: WAI-ARIA 1.2
Sintaksa
<button aria-labelledby="verb topic">Download</button>Identifikatori su odvojeni razmacima, a redoslijed referenci određuje redoslijed dijelova naziva. Koristi stabilne jedinstvene identifikatore i stvarne oznake, a ne nepovezan dugačak sadržaj.
Valjana referenca ima prednost pred aria-label. Ne zamjenjuje dodatni opis ili ponašanje izvorne oznake: klik na navedeni tekst ne fokusira automatski polje. Za obična polja preferiraj izvornu vezu oznake i kontrole.
U primjeru je report ranije u DOM-u, ali popis referenci stvara Download report. Test stabla pristupačnosti potvrđuje taj redoslijed i isključuje pričuvni naziv Fallback. Promjena rasporeda stranice ne zahtijeva promjenu redoslijeda naziva.
Primjeri
<!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>Rezultat
referenceOrder=Download report
Provjereni su izračunani naziv, redoslijed referenci i prednost pred tekstnom oznakom.