Кратко
СкопированоГлобальное состояние из 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
в разметке. Если скрипт не сработает, такие элементы всегда будут скрыты от скринридеров.