CKTIS / HTML
aria-describedby — descrizione supplementare di un controllo
`aria-describedby` collega un elemento a una spiegazione che ne completa il nome accessibile.
Versione: WAI-ARIA 1.2
Sintassi
<input aria-describedby="hint limit">Fornisci identificatori di elementi esistenti separati da spazi. Il loro testo forma la descrizione nell’ordine dei riferimenti. Mantieni breve e chiaro il nome del controllo; la spiegazione può indicare formato, limite o suggerimento.
Non sostituisce l’etichetta e non stabilisce regole di validazione. La struttura complessa della descrizione viene appiattita in testo: non considerarla quindi una navigazione in un pannello di aiuto interattivo. Le informazioni aggiuntive devono restare disponibili anche visivamente.
Il campo dell’esempio ha l’etichetta nativa Project code e due spiegazioni. Il test dell’albero di accessibilità verifica un nome distinto e la descrizione unita. Maximum 8 characters non impone un limite di lunghezza: quel vincolo deve essere implementato separatamente.
Esempi
<!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>Risultato
label=Project code; description=Use letters. Maximum 8 characters.
Verificati la descrizione calcolata e il nome del campo, non soltanto la presenza di identificatori nel codice HTML.