CKTIS / HTML
aria-describedby — dodatni opis kontrolnika
`aria-describedby` poveže element z razlago, ki dopolni njegovo dostopno ime.
Različica: WAI-ARIA 1.2
Sintaksa
<input aria-describedby="hint limit">Navedi s presledki ločene identifikatorje obstoječih elementov. Njihovo besedilo sestavi opis v vrstnem redu sklicev. Ime kontrolnika naj ostane kratko in jasno; razlaga lahko poda obliko podatkov, omejitev ali namig.
Ne nadomešča oznake in ne določa pravil preverjanja. Bogata struktura opisa se pretvori v besedilo, zato to ni navigacija po interaktivnem podoknu pomoči. Dodatne informacije naj ostanejo dostopne tudi vidno.
Polje v primeru ima vgrajeno oznako Project code in dve razlagi. Test drevesa dostopnosti potrdi ločeno ime in združen opis. Maximum 8 characters dolžine polja ne omejuje: to pravilo uvedi posebej.
Primeri
<!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>Rezultat
label=Project code; description=Use letters. Maximum 8 characters.
Preverjena sta izračunani opis in ime polja, ne le prisotnost identifikatorjev v HTML.