CKTIS / HTML
aria-labelledby — nombre a partir de elementos existentes
`aria-labelledby` construye un nombre accesible con el texto de los elementos referenciados mediante identificadores.
Versión: WAI-ARIA 1.2
Sintaxis
<button aria-labelledby="verb topic">Download</button>Los identificadores se separan por espacios y el orden de referencias determina el de los fragmentos del nombre. Usa identificadores estables y únicos y etiquetas reales, no contenido largo sin relación.
Una referencia válida tiene prioridad sobre aria-label. No sustituye una descripción adicional ni el comportamiento de una etiqueta nativa: pulsar el texto referenciado no enfoca automáticamente un campo. Para campos normales, prefiere la relación nativa entre etiqueta y control.
En el ejemplo, report aparece antes en el DOM, pero la lista de referencias construye Download report. La prueba del árbol de accesibilidad confirma ese orden y descarta el nombre alternativo Fallback. Cambiar la distribución de la página no obliga a cambiar el orden del nombre.
Ejemplos
<!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
Se verificaron el nombre calculado, el orden de referencias y la prioridad sobre la etiqueta textual.