Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes