CKTIS / HTML
aria-describedby — description complémentaire d’un contrôle
`aria-describedby` relie un élément à une explication qui complète son nom accessible.
Version : WAI-ARIA 1.2
Syntaxe
<input aria-describedby="hint limit">Fournissez des identifiants d’éléments existants, séparés par des espaces. Leur texte compose la description dans l’ordre des références. Gardez le nom du contrôle court et clair ; l’explication peut préciser un format, une limite ou un conseil.
Cela ne remplace pas l’étiquette et n’établit aucune règle de validation. La structure riche d’une description est aplatie en texte : n’y voyez donc pas une navigation dans un panneau d’aide interactif. Les informations complémentaires doivent aussi rester accessibles visuellement.
Le champ de l’exemple possède l’étiquette native Project code et deux explications. Le test de l’arbre d’accessibilité vérifie un nom distinct et une description combinée. Maximum 8 characters n’impose aucune longueur maximale : cette contrainte doit être implémentée séparément.
Exemples
<!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>Résultat
label=Project code; description=Use letters. Maximum 8 characters.
La description calculée et le nom du champ ont été vérifiés, pas seulement la présence d’identifiants dans le HTML.