From b9a63464e27be742356e92d07ad0150f8a0daf00 Mon Sep 17 00:00:00 2001 From: Oskar Date: Mon, 9 Oct 2023 21:01:58 +0300 Subject: [PATCH 01/19] branch update --- a11y/aria-live/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/a11y/aria-live/index.md b/a11y/aria-live/index.md index 771ed6cf62..83896b0f88 100644 --- a/a11y/aria-live/index.md +++ b/a11y/aria-live/index.md @@ -23,6 +23,7 @@ tags: [Свойство изменяющихся областей](/a11y/aria-attrs/#atributy-izmenyayushchihsya-oblastey) из [WAI-ARIA](/a11y/aria-intro/#specifikaciya). Делает часть страницы live region или «живой» областью. Благодаря этому вспомогательные технологии узнают обо всех изменениях в ней. + ## Пример ```html From 4f69162dc94b92cbfbd1cf0482f87d0714fa5dab Mon Sep 17 00:00:00 2001 From: OskarStud <93986921+OskarStud@users.noreply.github.com> Date: Mon, 9 Oct 2023 21:26:00 +0300 Subject: [PATCH 02/19] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=BB?= =?UTF-8?q?=D0=B5=D0=BD=D0=B0=20=D0=BF=D0=BE=D0=B4=D1=81=D0=BA=D0=B0=D0=B7?= =?UTF-8?q?=D0=BA=D0=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- a11y/aria-live/index.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/a11y/aria-live/index.md b/a11y/aria-live/index.md index 83896b0f88..a89def0bf6 100644 --- a/a11y/aria-live/index.md +++ b/a11y/aria-live/index.md @@ -48,3 +48,7 @@ tags: ## Как понять «Живая» область — это область страницы, в которой что-то обновляется из-за внешних событий. Например, появляется уведомление или ошибка к полю, если пользователь ввёл неправильные данные. Так пользователи [скринридеров](/a11y/screenreaders/) могут узнать об изменениях автоматически, без перехода к этой части страницы. + +## Подсказки + +Чтобы испытать работу живых областей можно воспользоваться [интерактивным примером](https://dequeuniversity.com/library/aria/liveregion-playground). From 4c2384320ee6c13299c0ab44afc73cd7929dcb58 Mon Sep 17 00:00:00 2001 From: OskarStud <93986921+OskarStud@users.noreply.github.com> Date: Tue, 10 Oct 2023 22:43:01 +0300 Subject: [PATCH 03/19] =?UTF-8?q?=D0=B4=D0=BE=D0=B1=D0=B0=D0=B2=D0=B8?= =?UTF-8?q?=D0=BB=20=D0=B8=D0=BD=D1=84=D0=BE=D1=80=D0=BC=D0=B0=D1=86=D0=B8?= =?UTF-8?q?=D0=B8=20=D0=BF=D0=BE=20=D0=B7=D0=BD=D0=B0=D1=87=D0=B5=D0=BD?= =?UTF-8?q?=D0=B8=D1=8F=D0=BC=20=D0=B4=D0=BB=D1=8F=20aria-live?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- a11y/aria-live/index.md | 23 ++++++++++++++++++----- 1 file changed, 18 insertions(+), 5 deletions(-) diff --git a/a11y/aria-live/index.md b/a11y/aria-live/index.md index a89def0bf6..ed571cf48b 100644 --- a/a11y/aria-live/index.md +++ b/a11y/aria-live/index.md @@ -37,13 +37,13 @@ tags: Добавьте к тегу атрибут `aria-live` с одним из трёх значений: -- `assertive` — срочные изменения, о них надо рассказать немедленно. -- `polite` — не очень важные изменения, можно рассказать о них после другого важного содержимого или завершения действия. -- `off` (по умолчанию) — не самые важные изменения, можно рассказать о них после всего остального. +- `assertive` — высший приоритет изменений, о них надо рассказать немедленно. Менее важные изменения будут озвучено после. Используется в элементах с [role=`alert`](/a11y/role-alert). +- `polite` — низкий приоритет изменений, можно рассказать о них после другого важного содержимого или завершения действия. Так ведут себя элементы с [role=`status`](/a11y/role-timer) и [role=`log`](/a11y/role-log). +- `off` (по умолчанию) — низший приоритет, изменения вообще не рассказываются. Используется в элементах с [role=`marquee`](/a11y/role-marquee) и [role=`timer`](/a11y/role-timer). Чаще всего понадобится значение `polite`. -`aria-live` можно использовать для всех тегов и [ARIA-ролей](/a11y/aria-roles/). +`aria-live` можно использовать для всех тегов и [ARIA-ролей](/a11y/aria-roles/). ## Как понять @@ -51,4 +51,17 @@ tags: ## Подсказки -Чтобы испытать работу живых областей можно воспользоваться [интерактивным примером](https://dequeuniversity.com/library/aria/liveregion-playground). +💡 Чтобы испытать работу живых областей можно воспользоваться [интерактивным примером](https://dequeuniversity.com/library/aria/liveregion-playground). + +💡 Не стоит использовать значение `assertive` без вынужденной необходимости. Потому что прерывания в чтение скринридера могут дизореинтировать пользователей или помещать выполнять им текущую задачу. + + + +https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-live +https://www.w3.org/TR/wai-aria-1.2/#aria-live +https://gomakethings.com/how-and-why-to-use-aria-live/ +https://dequeuniversity.com/library/aria/liveregion-playground +https://web.dev/hiding-and-updating-content/ +https://web-standards.ru/articles/aria-live-regions/ +https://doka.guide/a11y/aria-attrs/ +https://a11ysupport.io/ From ed13968c59c2e515ca8acc0bdeb012cb388e4829 Mon Sep 17 00:00:00 2001 From: Oskar Date: Thu, 12 Oct 2023 16:17:10 +0300 Subject: [PATCH 04/19] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=BB?= =?UTF-8?q?=D0=B5=D0=BD=20=D1=82=D0=B5=D0=BA=D1=81=D1=82=20=D0=BF=D0=BE=20?= =?UTF-8?q?=D0=BF=D0=BE=D0=B4=D1=81=D0=BA=D0=B0=D0=B7=D0=BA=D0=B0=D0=BC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- a11y/aria-live/index.md | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/a11y/aria-live/index.md b/a11y/aria-live/index.md index ed571cf48b..a6ecd0af98 100644 --- a/a11y/aria-live/index.md +++ b/a11y/aria-live/index.md @@ -41,20 +41,24 @@ tags: - `polite` — низкий приоритет изменений, можно рассказать о них после другого важного содержимого или завершения действия. Так ведут себя элементы с [role=`status`](/a11y/role-timer) и [role=`log`](/a11y/role-log). - `off` (по умолчанию) — низший приоритет, изменения вообще не рассказываются. Используется в элементах с [role=`marquee`](/a11y/role-marquee) и [role=`timer`](/a11y/role-timer). -Чаще всего понадобится значение `polite`. +Чаще всего используется значение `polite`. -`aria-live` можно использовать для всех тегов и [ARIA-ролей](/a11y/aria-roles/). +`aria-live` можно использовать для всех тегов и [ARIA-ролей](/a11y/aria-roles/). ## Как понять «Живая» область — это область страницы, в которой что-то обновляется из-за внешних событий. Например, появляется уведомление или ошибка к полю, если пользователь ввёл неправильные данные. Так пользователи [скринридеров](/a11y/screenreaders/) могут узнать об изменениях автоматически, без перехода к этой части страницы. -## Подсказки +«Живая» область включает в себя элемент и всех его потомков. Если атрибута `aria-live` нет у элемента, то значение берется от ближайшего родителя с установленным атрибутом `aria-live`. -💡 Чтобы испытать работу живых областей можно воспользоваться [интерактивным примером](https://dequeuniversity.com/library/aria/liveregion-playground). +## Подсказки + +💡 Чтобы испытать работу «живых» областей можно воспользоваться [интерактивным примером](https://dequeuniversity.com/library/aria/liveregion-playground). 💡 Не стоит использовать значение `assertive` без вынужденной необходимости. Потому что прерывания в чтение скринридера могут дизореинтировать пользователей или помещать выполнять им текущую задачу. +💡 [Сайт](https://a11ysupport.io/) позволит увидеть какие вспомогательные технологии поддерживают `aria-live`. + https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-live From 1deb4d4c127d9050552b84060ecde1380b411af0 Mon Sep 17 00:00:00 2001 From: Oskar Date: Thu, 12 Oct 2023 16:27:05 +0300 Subject: [PATCH 05/19] =?UTF-8?q?=D0=A3=D0=B4=D0=B0=D0=BB=D0=B5=D0=BD?= =?UTF-8?q?=D1=8B=20=D0=BB=D0=B8=D1=88=D0=BD=D0=B8=D0=B5=20=D1=81=D1=81?= =?UTF-8?q?=D1=8B=D0=BB=D0=BA=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- a11y/aria-live/index.md | 15 ++------------- 1 file changed, 2 insertions(+), 13 deletions(-) diff --git a/a11y/aria-live/index.md b/a11y/aria-live/index.md index a6ecd0af98..4b8825a0a2 100644 --- a/a11y/aria-live/index.md +++ b/a11y/aria-live/index.md @@ -49,23 +49,12 @@ tags: «Живая» область — это область страницы, в которой что-то обновляется из-за внешних событий. Например, появляется уведомление или ошибка к полю, если пользователь ввёл неправильные данные. Так пользователи [скринридеров](/a11y/screenreaders/) могут узнать об изменениях автоматически, без перехода к этой части страницы. -«Живая» область включает в себя элемент и всех его потомков. Если атрибута `aria-live` нет у элемента, то значение берется от ближайшего родителя с установленным атрибутом `aria-live`. +«Живая» область включает в себя элемент и всех его потомков. Если атрибута `aria-live` нет у элемента, то значение берётся от ближайшего родителя с установленным атрибутом `aria-live`. ## Подсказки 💡 Чтобы испытать работу «живых» областей можно воспользоваться [интерактивным примером](https://dequeuniversity.com/library/aria/liveregion-playground). -💡 Не стоит использовать значение `assertive` без вынужденной необходимости. Потому что прерывания в чтение скринридера могут дизореинтировать пользователей или помещать выполнять им текущую задачу. +💡 Не стоит использовать значение `assertive` без вынужденной необходимости. Потому что прерывания в чтение скринридера могут дезореинтировать пользователей или помещать выполнять им текущую задачу. 💡 [Сайт](https://a11ysupport.io/) позволит увидеть какие вспомогательные технологии поддерживают `aria-live`. - - - -https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-live -https://www.w3.org/TR/wai-aria-1.2/#aria-live -https://gomakethings.com/how-and-why-to-use-aria-live/ -https://dequeuniversity.com/library/aria/liveregion-playground -https://web.dev/hiding-and-updating-content/ -https://web-standards.ru/articles/aria-live-regions/ -https://doka.guide/a11y/aria-attrs/ -https://a11ysupport.io/ From ad3af7dd720ffb11bae35a46ad933b81cb6f7462 Mon Sep 17 00:00:00 2001 From: OskarStud <93986921+OskarStud@users.noreply.github.com> Date: Tue, 17 Oct 2023 22:25:27 +0300 Subject: [PATCH 06/19] add first demo --- .../demos/voice-change-content/index.html | 56 +++++++++++++++++++ 1 file changed, 56 insertions(+) create mode 100644 a11y/aria-live/demos/voice-change-content/index.html diff --git a/a11y/aria-live/demos/voice-change-content/index.html b/a11y/aria-live/demos/voice-change-content/index.html new file mode 100644 index 0000000000..7632d9c879 --- /dev/null +++ b/a11y/aria-live/demos/voice-change-content/index.html @@ -0,0 +1,56 @@ + + + + DEMO — ARTICLE — Дока + + + + + + + + + + +
+

new content box

+
+ +
+
+ + \ No newline at end of file From ce740786087a3b065696f6b207b698245166ae14 Mon Sep 17 00:00:00 2001 From: Oskar Date: Fri, 20 Oct 2023 15:37:35 +0300 Subject: [PATCH 07/19] =?UTF-8?q?=D0=98=D0=B7=D0=BC=D0=B5=D0=BD=D0=B8?= =?UTF-8?q?=D0=BB=20=D0=B4=D0=B5=D0=BC=D0=BE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../demos/assertive-more-important/index.html | 179 ++++++++++++++++++ .../demos/voice-change-content/index.html | 56 ------ 2 files changed, 179 insertions(+), 56 deletions(-) create mode 100644 a11y/aria-live/demos/assertive-more-important/index.html delete mode 100644 a11y/aria-live/demos/voice-change-content/index.html diff --git a/a11y/aria-live/demos/assertive-more-important/index.html b/a11y/aria-live/demos/assertive-more-important/index.html new file mode 100644 index 0000000000..d68bdc1577 --- /dev/null +++ b/a11y/aria-live/demos/assertive-more-important/index.html @@ -0,0 +1,179 @@ + + + + + DEMO — ARTICLE — Дока + + + + + + + + + + +
+
+ + + +
+ +
+
+ +
+ polite +

+
+
+
+ +
+ assertive +

+ +
+
+
+ +
+ off +

+
+
+
+
+
+
+ + + + \ No newline at end of file diff --git a/a11y/aria-live/demos/voice-change-content/index.html b/a11y/aria-live/demos/voice-change-content/index.html deleted file mode 100644 index 7632d9c879..0000000000 --- a/a11y/aria-live/demos/voice-change-content/index.html +++ /dev/null @@ -1,56 +0,0 @@ - - - - DEMO — ARTICLE — Дока - - - - - - - - - - -
-

new content box

-
- -
-
- - \ No newline at end of file From 7212f63fe5daf8beb9aeda63881bf92066ce430b Mon Sep 17 00:00:00 2001 From: Oskar Date: Mon, 23 Oct 2023 12:03:38 +0300 Subject: [PATCH 08/19] =?UTF-8?q?=D0=94=D0=BE=D0=B4=D0=B5=D0=BB=D0=B0?= =?UTF-8?q?=D0=BD=20=D0=BF=D1=80=D0=B8=D0=BC=D0=B5=D1=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../demos/assertive-more-important/index.html | 62 ++++--------------- a11y/aria-live/index.md | 4 ++ 2 files changed, 17 insertions(+), 49 deletions(-) diff --git a/a11y/aria-live/demos/assertive-more-important/index.html b/a11y/aria-live/demos/assertive-more-important/index.html index d68bdc1577..d62684dca2 100644 --- a/a11y/aria-live/demos/assertive-more-important/index.html +++ b/a11y/aria-live/demos/assertive-more-important/index.html @@ -9,7 +9,6 @@ @@ -87,22 +120,21 @@
-
+
polite -

+

-
+
assertive -

- +

-
+
off -

+

@@ -139,5 +171,4 @@ }) }) - From f12667464f91c78b6dbc916dfdc3bc30e79b6bee Mon Sep 17 00:00:00 2001 From: Tatiana Fokina Date: Sat, 28 Oct 2023 23:47:49 +0400 Subject: [PATCH 18/19] =?UTF-8?q?=D0=98=D0=B7=D0=BC=D0=B5=D0=BD=D1=8F?= =?UTF-8?q?=D0=B5=D1=82=20`title`=20=D1=84=D1=80=D0=B5=D0=B9=D0=BC=D0=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- a11y/aria-live/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/a11y/aria-live/index.md b/a11y/aria-live/index.md index d843657760..b8e6738441 100644 --- a/a11y/aria-live/index.md +++ b/a11y/aria-live/index.md @@ -46,7 +46,7 @@ tags: В примере показано, как будет читаться высшее по приоритету значение `assertive` при одновременном изменении содержимого. Для того, чтобы услышать результат, используйте [скринридер](/a11y/screenreaders/): - + ## Как понять From 32448c4d6a48563f7629292abcf46f5f1ba734b0 Mon Sep 17 00:00:00 2001 From: Tatiana Fokina Date: Sat, 28 Oct 2023 23:58:27 +0400 Subject: [PATCH 19/19] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=BB?= =?UTF-8?q?=D1=8F=D0=B5=D1=82=20=D0=B7=D0=B0=D0=B1=D1=8B=D1=82=D0=BE=D0=B5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../demos/assertive-more-important/index.html | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/a11y/aria-live/demos/assertive-more-important/index.html b/a11y/aria-live/demos/assertive-more-important/index.html index d822747b9a..8266571384 100644 --- a/a11y/aria-live/demos/assertive-more-important/index.html +++ b/a11y/aria-live/demos/assertive-more-important/index.html @@ -6,7 +6,7 @@ - +