Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje