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

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

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

Източници