Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / HTML

aria-describedby — doplňujúci opis kontrolky

`aria-describedby` spája prvok s vysvetlením, ktoré dopĺňa jeho prístupný názov.

Verzia: WAI-ARIA 1.2

Syntax

<input aria-describedby="hint limit">

Uveď identifikátory existujúcich prvkov oddelené medzerami. Ich text tvorí opis v poradí odkazov. Názov samotnej kontrolky ponechaj krátky a jasný; vysvetlenie môže uvádzať formát, limit alebo pomôcku.

Nenahrádza označenie a neurčuje validačné pravidlá. Bohatá štruktúra opisu sa splošťuje na text, preto nejde o navigáciu v interaktívnom paneli pomoci. Informácie majú zostať prístupné aj vizuálne.

Pole v príklade má natívne označenie Project code a dve vysvetlenia. Test stromu prístupnosti overuje osobitný názov a spojený opis. Maximum 8 characters neobmedzuje dĺžku poľa: toto obmedzenie treba implementovať samostatne.

Príklady

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

Výsledok

label=Project code; description=Use letters. Maximum 8 characters.

Overený je vypočítaný opis a názov poľa, nie iba prítomnosť identifikátorov v HTML.

Zdroje