CKTIS / HTML
role — роля на елемент за достъпността
Атрибутът `role` указва семантичната роля на елемента за помощните технологии. Той не добавя външен вид или поведение. Използвайте го според правилата на ARIA in HTML и предпочитайте елементи, които вече предоставят подходяща вградена семантика.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
role="role-name [fallback-role-name ...]"Атрибутът role съобщава на помощните технологии типа на даден елемент, например група или бутон. Той се отнася до семантиката в дървото за достъпност, а не до външния вид. Не замества достъпното име: в примера group задава ролята, а aria-label предоставя името Display options.
Стойността може да съдържа имена на роли, разделени с празни знаци. При определяне на ролята браузърът използва първото разпознато име на неабстрактна роля. Списъкът предоставя резервни роли, а не няколко едновременно действащи роли. Така избраната роля обаче не е непременно тази, която браузърът представя в дървото за достъпност. Например при елемент button, който може да получи фокус, браузърът трябва да пренебрегне none или presentation и вместо това да представи подразбиращата се роля на бутон. Абстрактните роли не трябва да се използват в съдържанието на страница.
Предпочитайте вграден HTML елемент с подходяща семантика. button вече има роля на бутон, затова повторението ѝ е излишно. Допустимите замени зависят от елемента и правилата на ARIA in HTML; не всяка роля е валидна навсякъде. Спазвайте и изискванията на избраната роля за имена, състояния и структура.
Самото добавяне на role="button" не осигурява управление с клавиатура, възможност за получаване на фокус или действия. Примерът групира два вградени радиобутона (<input type="radio">), без да заменя ролите им. При смяна на избраната опция скриптът променя размера на шрифта на примерния текст. output показва записаното в конзолата: декларираните стойности на role и aria-label и видимия текст на групата. Това не е резултат от проверка на дървото за достъпност.
Примери
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Named group of display options</title>
</head>
<body>
<div id="display-options" role="group" aria-label="Display options">
<label><input type="radio" name="zoom" value="normal" checked> Normal size</label>
<label><input type="radio" name="zoom" value="large"> Large size</label>
</div>
<p id="sample">Sample text</p>
<script>
const group = document.getElementById('display-options');
const sample = document.getElementById('sample');
group.addEventListener('change', event => {
sample.style.fontSize = event.target.value === 'large' ? '1.5em' : '1em';
});
console.log('Declared role: ' + group.getAttribute('role'));
console.log('ARIA label: ' + group.getAttribute('aria-label'));
console.log('Visible group text: ' + group.innerText.trim().replace(/\s+/g, ' '));
</script>
</body>
</html>Резултат
Declared role: group ARIA label: Display options Visible group text: Normal size Large size
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.