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

CKTIS / HTML

aria-modal — семантика на модалните диалогови прозорци

Атрибутът aria-modal указва на помощните технологии дали показан елемент е модален, тоест дали взаимодействието е ограничено до съдържанието му. Сам по себе си той не блокира фона и не управлява фокуса: декларацията трябва да съответства на действителното поведение на интерфейса.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

aria-modal="true" | aria-modal="false"

aria-modal е свойство на WAI-ARIA, използвано в HTML, за да указва дали показан елемент е модален. Стойността true означава модалност; false е стойността по подразбиране. Това свойство приема текстовите стойности true и false и не следва синтаксиса на булевите HTML атрибути: не изписвайте името на атрибута без стойност. Поддържа се за ролите dialog и alertdialog, а не глобално за произволни елементи.

aria-modal="true" предава семантика на помощните технологии, които могат да ограничат навигацията до съдържанието на диалоговия прозорец. То не отваря прозорец, не блокира кликванията във фона и не премества или задържа фокуса. Задавайте тази стойност само когато интерфейсът действително не позволява на никого да взаимодейства със съдържание извън диалога и фонът е визуално затъмнен или скрит.

При отваряне преместете фокуса в диалоговия прозорец и задръжте последователността от Tab и Shift+Tab в него. Осигурете бутон за затваряне вътре и поддръжка на Escape; при затваряне обикновено възстановявайте фокуса върху елемента, който е отворил прозореца. Задайте на диалога достъпно име, например чрез aria-labelledby, което сочи към видимото му заглавие. Всички контроли, необходими за използването на диалоговия прозорец, трябва да са вложени в неговия елемент в DOM дървото.

Примерът използва вграден диалогов прозорец, отворен с showModal(), вместо ръчно да пресъздава модалното поведение. В този случай изричното aria-modal="true" е излишно, защото вградената модалност вече се предоставя на помощните технологии; атрибутът е оставен, за да покаже синтаксиса. Самото добавяне на атрибута към обикновен контейнер не осигурява това поведение. Проверете отделно управлението с клавиатура и семантиката в дървото на достъпността.

Примери

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>aria-modal example</title>
<style>
  dialog::backdrop { background: rgb(0 0 0 / 50%); }
</style>
<button id="open" type="button">Open dialog</button>
<dialog id="notice" aria-modal="true" aria-labelledby="heading">
  <h2 id="heading">Notice</h2>
  <p>This dialog blocks interaction with the page.</p>
  <button id="close" type="button" autofocus>Close</button>
</dialog>
<script>
  const opener = document.getElementById('open');
  const notice = document.getElementById('notice');
  const closer = document.getElementById('close');
  opener.addEventListener('click', () => notice.showModal());
  closer.addEventListener('click', () => notice.close());
  notice.addEventListener('close', () => opener.focus());
</script>
</html>

Резултат

Initially, only Open dialog is visible. Activating it opens Notice, dims the background, and focuses Close. Background controls cannot be activated while the dialog is open. Close or Escape dismisses the dialog and returns focus to Open dialog.

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

Източници