CKTIS / HTML
aria-labelledby — název z existujících prvků
`aria-labelledby` sestavuje přístupný název z textu prvků odkazovaných identifikátory.
Verze: WAI-ARIA 1.2
Syntaxe
<button aria-labelledby="verb topic">Download</button>Identifikátory odděluj mezerami; jejich pořadí určuje pořadí částí názvu. Používej stabilní jedinečné identifikátory a skutečná označení, ne nesouvisející dlouhý obsah.
Platný odkaz má přednost před aria-label. Nenahrazuje doplňující popis ani chování nativní etikety: kliknutí na odkazovaný text automaticky nepřesune fokus do pole. Pro běžná pole preferuj nativní vazbu označení a prvku.
V příkladu je report v DOM dříve, ale seznam odkazů vytvoří Download report. Test stromu přístupnosti potvrdí pořadí i vynechání záložního názvu Fallback. Změna rozvržení stránky nevyžaduje změnu pořadí názvu.
Pří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ýsledek
referenceOrder=Download report
Ověřen je vypočtený název, pořadí odkazů a přednost před textovým označením.