Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri