CKTIS / HTML
aria-describedby — descripción complementaria de un control
`aria-describedby` conecta un elemento con una explicación que complementa su nombre accesible.
Versión: WAI-ARIA 1.2
Sintaxis
<input aria-describedby="hint limit">Indica identificadores de elementos existentes separados por espacios. Su texto forma la descripción en el orden de las referencias. Mantén breve y claro el nombre propio del control; la explicación puede indicar un formato, límite o consejo.
No sustituye a la etiqueta ni establece reglas de validación. La estructura enriquecida se aplana a texto, por lo que no equivale a navegar por un panel de ayuda interactivo. La información adicional también debe seguir disponible visualmente.
El campo del ejemplo tiene la etiqueta nativa Project code y dos explicaciones. La prueba del árbol de accesibilidad comprueba un nombre independiente y la descripción combinada. Maximum 8 characters no impone un límite de longitud: esa restricción debe implementarse aparte.
Ejemplos
<!doctype html><meta charset="utf-8">
<label for="code">Project code</label><input id="code" aria-describedby="hint limit">
<p id="hint">Use letters.</p><p id="limit">Maximum 8 characters.</p>
<output id="result"></output>
<script>
const input = document.querySelector('#code');
input.focus();
document.querySelector('#result').textContent = 'label=' + input.labels[0].textContent + '; description=' + input.getAttribute('aria-describedby').split(' ').map(id => document.getElementById(id).textContent).join(' ');
</script>Resultado
label=Project code; description=Use letters. Maximum 8 characters.
Se verificaron la descripción calculada y el nombre del campo, no solo la presencia de identificadores en HTML.