Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

aria-describedby — doplňující popis ovládacího prvku

`aria-describedby` propojuje prvek s vysvětlením, které doplňuje jeho přístupný název.

Verze: WAI-ARIA 1.2

Syntaxe

<input aria-describedby="hint limit">

Uveď identifikátory existujících prvků oddělené mezerami. Jejich text vytvoří popis v pořadí odkazů. Název samotného prvku udrž krátký a jasný; vysvětlení může uvádět formát, limit či nápovědu.

Nenahrazuje označení a nezavádí validační pravidla. Struktura bohatého popisu se převádí na prostý text, nejde tedy o navigaci v interaktivním panelu pomoci. Informace mají zůstat dostupné také vizuálně.

Pole v příkladu má nativní označení Project code a dvě vysvětlení. Test stromu přístupnosti potvrzuje samostatný název a spojený popis. Věta Maximum 8 characters délku pole neomezuje: toto omezení implementuj zvlášť.

Pří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ýsledek

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

Ověřen je vypočtený popis a název pole, nikoli jen přítomnost identifikátorů v HTML.

Zdroje