+
+
+
+
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/).
-- [`