complementary

Как добавить ориентир для дополнительного содержимого с помощью WAI-ARIA.

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

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

Кратко

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

ARIA-роль ориентира. Определяет область с дополнительным содержимым, которое не теряет смысл без основного. К примеру, боковая колонка на странице.

Роль complementary есть у <aside> по умолчанию.

Пример

Секция статьи "Пример"
        
          
          <div role="complementary">  <h2>Популярные статьи</h2>  <ul>    <li>      <a href="#">5 признаков того, что кот вас любит</a>    </li>    <li>      <a href="#">Популярные фасоны шляп для лягушек</a>    </li>    <li>      <a href="#">Вяжем носки для морских свинок</a>    </li>  </ul></div>
          <div role="complementary">
  <h2>Популярные статьи</h2>
  <ul>
    <li>
      <a href="#">5 признаков того, что кот вас любит</a>
    </li>
    <li>
      <a href="#">Популярные фасоны шляп для лягушек</a>
    </li>
    <li>
      <a href="#">Вяжем носки для морских свинок</a>
    </li>
  </ul>
</div>

        
        
          
        
      

Как пишется

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

Добавьте к тегу role="complementary". Лучше, чтобы это были семантически нейтральные <div> или <span>. Одно из правил использования ARIA — не перезаписывать роли без необходимости.

В большинстве случаев лучше использовать <aside> вместо роли complementary.

Для элемента с ролью complementary можно использовать все глобальные ARIA-атрибуты.

Как понять

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

Роль complementary создаёт ориентир на странице. Это значит, что пользователи скринридеров могут быстро переместиться к этой части страницы с помощью горячих клавиш или через меню со всеми ориентирами.