Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori