CKTIS / HTML
aria-labelledby — názov z existujúcich prvkov
`aria-labelledby` zostavuje prístupný názov z textu prvkov určených identifikátormi.
Verzia: WAI-ARIA 1.2
Syntax
<button aria-labelledby="verb topic">Download</button>Identifikátory oddeľ medzerami; ich poradie určuje poradie častí názvu. Používaj stabilné jedinečné identifikátory a skutočné označenia, nie nesúvisiaci dlhý obsah.
Platný odkaz má prednosť pred aria-label. Nenahrádza doplňujúci opis ani správanie natívnej etikety: kliknutie na odkazovaný text automaticky neprenesie fokus do poľa. Pri bežných poliach uprednostni natívnu väzbu označenia a kontrolky.
V príklade sa report nachádza v DOM skôr, ale zoznam odkazov vytvorí Download report. Test stromu prístupnosti overí poradie a vynechanie záložného názvu Fallback. Zmena rozloženia stránky nevyžaduje zmenu poradia názvu.
Príklady
<!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>Výsledok
referenceOrder=Download report
Overený je vypočítaný názov, poradie odkazov a prednosť pred textovým označením.