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 сама не затваря известието.