timer

Роль для области со счётчиком.

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

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

Кратко

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

Роль изменяющихся областей. Делает часть страницы live region или «живой» областью. timer нужна для областей со счётчиками, которые отсчитывают время в обычном или обратном порядке.

Пример

Секция статьи "Пример"
        
          
          <div id="clock" role="timer" aria-live="polite">  <span id="clock-hours"></span>  <span id="clock-mins"></span></div>
          <div id="clock" role="timer" aria-live="polite">
  <span id="clock-hours"></span>
  <span id="clock-mins"></span>
</div>

        
        
          
        
      

Как пишется

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

Добавьте к тегу атрибут role="timer". Роль можно использовать для всех тегов.

У timer по умолчанию есть свойство aria-live="off".

Скринридер объявит об изменениях в области с timer после завершения пользователями действий со страницей и другой информации.

Чтобы скринридер объявлял об изменениях через определённый интервал времени, используйте JavaScript. Для этого переключайте значение aria-live c off на polite через нужный промежуток времени. Например, каждые 60 минут.

Как понять

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

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

Роль timer часто используют для таймеров.