Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / HTML

aria-describedby — dodatni opis kontrole

`aria-describedby` povezuje element s objašnjenjem koje nadopunjuje njegov pristupačni naziv.

Verzija: WAI-ARIA 1.2

Sintaksa

<input aria-describedby="hint limit">

Navedi identifikatore postojećih elemenata odvojene razmacima. Njihov tekst tvori opis redoslijedom referenci. Naziv same kontrole neka bude kratak i jasan; objašnjenje može sadržavati format, ograničenje ili pomoć.

Ne zamjenjuje oznaku i ne postavlja pravila validacije. Bogata struktura opisa svodi se na tekst, pa to nije navigacija interaktivnim panelom pomoći. Dodatne informacije trebaju ostati dostupne i vizualno.

Polje u primjeru ima izvornu oznaku Project code i dva objašnjenja. Test stabla pristupačnosti provjerava zaseban naziv i spojeni opis. Maximum 8 characters ne ograničava duljinu polja: to pravilo implementiraj zasebno.

Primjeri

<!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.

Provjereni su izračunani opis i naziv polja, a ne samo prisutnost identifikatora u HTML-u.

Izvori