diff --git a/a11y/aria-expanded/demos/burger-menu/index.html b/a11y/aria-expanded/demos/burger-menu/index.html new file mode 100644 index 0000000000..afe950d697 --- /dev/null +++ b/a11y/aria-expanded/demos/burger-menu/index.html @@ -0,0 +1,174 @@ + + + + Бургер-меню — aria-expanded — Дока + + + + + + + + + + + + + diff --git a/a11y/aria-expanded/index.md b/a11y/aria-expanded/index.md index 444cbea680..024562df7c 100644 --- a/a11y/aria-expanded/index.md +++ b/a11y/aria-expanded/index.md @@ -1,65 +1,92 @@ --- title: "`aria-expanded`" -description: "ARIA-атрибут для элементов, которые разворачивают и сворачивают другие элементы или содержимое." +description: "Как рассказать скринридерам, что элемент что-то разворачивает и сворачивает." authors: - - doka-dog + - tatianafokina +contributors: + - skorobaeus keywords: + - a11y - доступность - ARIA - ARIA-атрибут + - expandable widget related: - a11y/aria-owns - - a11y/aria-attrs + - a11y/aria-haspopup - a11y/aria-controls tags: - doka - - placeholder --- ## Кратко -[Состояние виджета](/a11y/aria-attrs/#atributy-vidzhetov) из [WAI-ARIA](/a11y/aria-intro/#specifikaciya). Даёт вспомогательным технологиям понять, что элемент что-то разворачивает или сворачивает. +[Состояние виджета](/a11y/aria-attrs/#atributy-vidzhetov) из [WAI-ARIA](/a11y/aria-intro/#specifikaciya). Сообщает вспомогательным технологиям, что элемент разворачивает и сворачивает другое содержимое. + +`aria-expanded` нужен для компонентов, которые изменяют видимость содержимого. Например для кнопки, которая показывает или скрывает список ссылок на сайте. ## Пример ```html - - + ``` + + +[Скринридер](/a11y/screenreaders/) при фокусе на кнопке расскажет о ней примерно так: «Список товаров, кнопка, свёрнуто». Когда пользователь раскроет список, скринридер просто сообщит «развёрнуто» без повторения информации о кнопке. + ## Как пишется -Добавьте к тегу атрибут `aria-expanded` с одним из трёх значений: +Добавьте к элементу атрибут `aria-expanded` с одним из трёх значений: +- `undefined` (по умолчанию) — у элемента нет содержимого, которое разворачивается и сворачивается. - `true` — содержимое или другие элементы развёрнуты. - `false` — содержимое или другие элементы свёрнуты. -- `undefined` (по умолчанию) — у элемента нет содержимого, которое разворачивается и сворачивается. -Атрибут можно использовать только для некоторых тегов и [ARIA-ролей](/a11y/aria-roles/): +`aria-expanded` используют для интерактивных элементов, с которыми могут взаимодействовать пользователи. Так что атрибут подходит только для некоторых HTML-тегов и [ARIA-ролей](/a11y/aria-roles/): -- [``](/html/a/) или [`link`](/a11y/role-link/). -- [`