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

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.

Fuentes