CKTIS / HTML
aria-describedby — aanvullende beschrijving van een bedieningselement
`aria-describedby` verbindt een element met uitleg die zijn toegankelijke naam aanvult.
Versie: WAI-ARIA 1.2
Syntax
<input aria-describedby="hint limit">Geef identificaties van bestaande elementen op, gescheiden door spaties. Hun tekst vormt de beschrijving in de volgorde van de verwijzingen. Houd de eigen naam van het bedieningselement kort en duidelijk; de uitleg kan een formaat, limiet of tip noemen.
Het vervangt het label niet en stelt geen validatieregels in. Een rijke beschrijvingsstructuur wordt afgevlakt tot tekst; behandel dit dus niet als navigatie door een interactief hulppaneel. Aanvullende informatie moet ook visueel beschikbaar blijven.
Het voorbeeldveld heeft het native label Project code en twee toelichtingen. De test van de toegankelijkheidsboom controleert een afzonderlijke naam en een gecombineerde beschrijving. Maximum 8 characters dwingt geen lengtelimiet af: implementeer die beperking apart.
Voorbeelden
<!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>Resultaat
label=Project code; description=Use letters. Maximum 8 characters.
De berekende beschrijving en veldnaam zijn gecontroleerd, niet alleen de aanwezigheid van identificaties in HTML.