CKTIS / HTML
aria-labelledby — nome ricavato da elementi esistenti
`aria-labelledby` costruisce un nome accessibile dal testo degli elementi referenziati tramite identificatori.
Versione: WAI-ARIA 1.2
Sintassi
<button aria-labelledby="verb topic">Download</button>Gli identificatori sono separati da spazi e l’ordine dei riferimenti determina quello dei frammenti del nome. Usa identificatori stabili e univoci ed etichette reali, non contenuti lunghi senza relazione.
Un riferimento valido ha precedenza su aria-label. Non sostituisce una descrizione aggiuntiva né il comportamento dell’etichetta nativa: fare clic sul testo referenziato non porta automaticamente il focus al campo. Per campi ordinari preferisci la relazione nativa tra etichetta e controllo.
Nell’esempio report appare prima nel DOM, ma l’elenco dei riferimenti forma Download report. Il test dell’albero di accessibilità conferma quell’ordine ed esclude il nome di riserva Fallback. Cambiare l’impaginazione non impone di modificare l’ordine del nome.
Esempi
<!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>Risultato
referenceOrder=Download report
Verificati il nome calcolato, l’ordine dei riferimenti e la precedenza sull’etichetta testuale.