База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / HTML

aria-describedby — допълнително описание на контрола

`aria-describedby` свързва елемент с обяснение, което допълва достъпното му име.

Версия: WAI-ARIA 1.2

Синтаксис

<input aria-describedby="hint limit">

Посочи идентификаторите на съществуващи елементи, разделени с интервали. Текстът им образува описанието в реда на препратките. Името на контролата трябва да е кратко и ясно; обяснението може да посочва формат, ограничение или подсказка.

Не заменя етикета и не задава правила за валидация. Богатата структура на описанието се свежда до текст, затова това не е навигация в интерактивен помощен панел. Допълнителната информация трябва да остане достъпна и визуално.

Полето в примера има стандартен етикет Project code и две обяснения. Тестът на дървото за достъпност потвърждава отделно име и обединено описание. Maximum 8 characters не ограничава дължината на полето: това правило се реализира отделно.

Примери

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

Резултат

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

Проверени са изчисленото описание и името на полето, не само наличието на идентификатори в HTML.

Източници