CKTIS / HTML
aria-labelledby — nome a partir de elementos existentes
`aria-labelledby` constrói um nome acessível a partir do texto dos elementos referenciados por identificadores.
Versão: WAI-ARIA 1.2
Sintaxe
<button aria-labelledby="verb topic">Download</button>Os identificadores são separados por espaços, e a ordem das referências determina a dos fragmentos do nome. Usa identificadores estáveis e únicos e etiquetas reais, não conteúdos extensos sem relação.
Uma referência válida tem prioridade sobre aria-label. Não substitui uma descrição adicional nem o comportamento de uma etiqueta nativa: clicar no texto referenciado não coloca automaticamente o foco no campo. Para campos comuns, prefere a relação nativa entre etiqueta e controlo.
No exemplo, report aparece mais cedo no DOM, mas a lista de referências forma Download report. O teste da árvore de acessibilidade confirma essa ordem e exclui o nome alternativo Fallback. Mudar a disposição da página não exige mudar a ordem do nome.
Exemplos
<!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>Resultado
referenceOrder=Download report
Verificaram-se o nome calculado, a ordem das referências e a prioridade sobre a etiqueta textual.