Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes