Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje