aria-atomic

Одно из свойств изменяющихся областей для определения объёма изменений, о которых расскажет скринридер.

Время чтения: меньше 5 мин

Это незавершённая статья. Вы можете помочь её закончить! Почитайте о том, как контрибьютить в Доку.

Кратко

Секция статьи "Кратко"

Свойство изменяющихся областей из WAI-ARIA. aria-atomic нужно для указания объёма изменений, о котором сообщит вспомогательная технология на основе значения aria-relevant. Это вся «живая» область или её часть.

Пример

Секция статьи "Пример"
        
          
          <div aria-live="polite" aria-atomic="true">  <h2>Текущий счёт</h2>  <span>1/1 после первого раунда</span></div>
          <div aria-live="polite" aria-atomic="true">
  <h2>Текущий счёт</h2>
  <span>1/1 после первого раунда</span>
</div>

        
        
          
        
      

Как пишется

Секция статьи "Как пишется"

Добавьте к тегу атрибут aria-atomic с одним из двух значений:

  • true — вспомогательная технология расскажет обо всех элементах в интерактивной области.
  • false (по умолчанию) — вспомогательная технология расскажет только об изменениях.

aria-atomic можно использовать для всех тегов и ARIA-ролей.

Как понять

Секция статьи "Как понять"

«Живая» область — это область страницы, в которой что-то постоянно обновляется из-за внешних событий. Например, появляется уведомление или ошибка у поля, когда пользователь ввёл неправильные данные. Так пользователи скринридеров могут узнать об изменениях автоматически, без перехода к этой части страницы.