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

CKTIS / HTML

aria-label — текстово достъпно име

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

Версия: WAI-ARIA 1.2

Синтаксис

<button aria-label="Close notice">×</button>

Посочи кратко преведено име на действието, например Close notice за бутон за затваряне. Атрибутът не дава роля на произволен елемент. Когато е възможен видим текст или стандартен етикет, това обикновено е по-добрият избор.

Името може да замени текста на съдържанието. Включи видимия етикет, за да съответства гласовото управление на екрана. Валидно aria-labelledby има предимство. Това не е изскачаща подсказка, указание за работа или обработчик на събития.

Бутонът с икона в примера има име Close notice, а декоративният знак е изключен от достъпността. Отделна функция скрива известието при активиране. Тестът потвърждава изчисленото име и затварянето; превеждай името заедно с интерфейса.

Примери

<!doctype html><meta charset="utf-8">
<p id="notice">Your settings were saved.</p>
<button id="close" aria-label="Close notice"><span aria-hidden="true">×</span></button>
<output id="result"></output>
<script>
document.querySelector('#close').addEventListener('click', () => { document.querySelector('#notice').hidden = true; });
document.querySelector('#close').click();
document.querySelector('#result').textContent = 'noticeHidden=' + document.querySelector('#notice').hidden;
</script>

Резултат

noticeHidden=true

Проверени са името и действието на бутона; ARIA сама не затваря известието.

Източници