Кратко
СкопированоГлобальное состояние из WAI-ARIA в котором элемент скрыт от вспомогательных технологий, но виден всем остальным пользователям.
Пример
Скопировано
<button class="button button-aqua"> <span class="material-symbols-outlined" aria-hidden="true"> logout </span> <span class="visually-hidden"> Выйти из аккаунта </span></button>
<button class="button button-aqua">
<span class="material-symbols-outlined" aria-hidden="true">
logout
</span>
<span class="visually-hidden">
Выйти из аккаунта
</span>
</button>
Как пишется
СкопированоДобавьте к тегу aria с одним из значений:
false— элемент виден вспомогательным технологиям.true— элемент скрыт от вспомогательных технологий.undefined(по умолчанию) — браузер сам определяет скрыт элемент или нет в зависимости от его стилей и видимости на странице.
Как это понять
СкопированоИспользуйте aria, когда элемент надо скрыть только от пользователей вспомогательных технологий. Типичные ситуации:
- избыточный или дублирующийся текст;
- декоративный контент — иконочный шрифт или Unicode-символы в элементах управления;
- временно скрытые или свёрнутые элементы, например, выпадающее меню.
aria можно применять ко всем неинтерактивным элементам, которые не скрыты другими способами:
- HTML-атрибутом
hidden; - CSS-свойствами
displayили: none visibility.: hidden
Подсказки
Скопировано💡 Хорошая практика — текстовый эквивалент для скрытого содержимого. Идеально, если он доступен и для зрячих пользователей. Тексты в элементах управления особенно полезны для пользователей программ голосового управления.
💡 Если внутри неинтерактивного элемента с aria есть интерактивные, то они скроются не во всех браузерах и не от всех скринридеров.
💡 Когда используете aria для скрытия и показа элементов с помощью JavaScript, рекомендуется не прописывать aria в разметке. Если скрипт не сработает, такие элементы всегда будут скрыты от скринридеров.