From c1dd1bbdefd112c56262011ce09d4f100d1c6bc1 Mon Sep 17 00:00:00 2001 From: Tianyi Tao <146603607+tianyeeT@users.noreply.github.com> Date: Mon, 27 May 2024 22:09:00 +0800 Subject: [PATCH 1/7] [zh-cn]: create the translation of `aria/aria_screen_reader_implementors_guide` --- .../index.md | 25 +++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md diff --git a/files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md b/files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md new file mode 100644 index 00000000000000..24ea2664aba29e --- /dev/null +++ b/files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md @@ -0,0 +1,25 @@ +--- +title: ARIA 屏幕阅读器实施指南 +slug: Web/Accessibility/ARIA/ARIA_Screen_Reader_Implementors_Guide +l10n: + sourceCommit: 019ca5c9ce641bfa02825e1ba0444f35dfb646cc +--- + +{{AccessibilitySidebar}} + +## 实时区域 +这只是一个指南。实时区域标记是一个相对开放于解释的复杂领域。以下旨在提供实现指导，以尊重屏幕阅读器开发者尝试不同方法的需求。其目的是在提供有关如何使用标记的预期含义的有用指导的同时，支持实时区域作为屏幕阅读器创新和竞争的领域之间达成平衡。 + +### 解释 WAI-ARIA 实时区域标记 +1. 实时更改是提示：一般情况下，实时区域标记是由作者提供的提示，辅助技术可以允许全局、站点甚至区域特定的设置，以及启发式方法来帮助处理没有 WAI-ARIA 提示的页面上的实时更改。 +2. 可选择地，如果用户配置了第二个硬件通道，则创建第二个额外的队列：如果有两个用于呈现的通道（例如文本到语音和点字显示），则可以维护两个队列以实现并行呈现。通道可以根据角色或礼貌度进行用户配置，用于呈现实时区域。 +3. 忙碌区域：在带有 aria-busy="true" 标记的区域中的任何更改都不应在清除该属性之前添加到队列中。 +4. 礼貌度（`aria-live` 或来源于[role](/zh-CN/docs/Web/Accessibility/ARIA/Roles)）优先级最高：根据 aria-live 属性或从角色继承的礼貌度级别将项目添加到队列中（例如，[role="log"](/zh-CN/docs/Web/Accessibility/ARIA/Roles/log_role) 默认为礼貌）。断言项目优先于礼貌度级别。另外，实现可能选择清除更礼貌的项目，例如，断言项目会清除队列中的任何礼貌项目。 +5. 时间次之：根据事件发生的时间顺序（较早的事件优先），对具有相同礼貌度级别的项目进行排序。以发生顺序的顺序呈现相同礼貌度级别的项目。 +6. 具有多个更改的原子（`aria-atomic="true"`）区域不应重复呈现相同的内容。随着为原子区域添加到队列的新事件，删除同一区域的早期事件。可能希望在呈现原子区域更改之前至少有一个微小的超时，以避免在彼此之后快速发生的两个更改中两次呈现该区域。 +7. 在呈现更改时包括标签：如果更改发生在具有某种语义标签的内容中，请朗读标签。这对于数据单元格中的更改尤其重要，其中列和行标题提供了重要的上下文信息。 + +### 设置和启发式方法的想法 +1. 允许使用不同的语音（在文本到语音中）或其他不同的呈现特征来区分实时更改。 +2. 当没有 WAI-ARIA 标记时，除非用户将所有实时更改配置为关闭，否则自动呈现一些更改。例如，在用户自己的输入的上下文中自动朗读由用户输入引起的更改。 +3. 允许全局设置关闭实时更改的呈现，呈现所有实时更改，使用标记，或者是"智能"（使用启发式方法）。 From 6d16190a03ab57a28f4e0a6288230e577f5c4ed3 Mon Sep 17 00:00:00 2001 From: Tianyi Tao <146603607+tianyeeT@users.noreply.github.com> Date: Mon, 27 May 2024 22:29:11 +0800 Subject: [PATCH 2/7] Update files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --- .../aria/aria_screen_reader_implementors_guide/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md b/files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md index 24ea2664aba29e..7fb036a36424d5 100644 --- a/files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md +++ b/files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md @@ -2,7 +2,7 @@ title: ARIA 屏幕阅读器实施指南 slug: Web/Accessibility/ARIA/ARIA_Screen_Reader_Implementors_Guide l10n: - sourceCommit: 019ca5c9ce641bfa02825e1ba0444f35dfb646cc + sourceCommit: 019ca5c9ce641bfa02825e1ba0444f35dfb646cc --- {{AccessibilitySidebar}} From 01c409365e2f1ff30b619b9cf20fcfdff200d4ee Mon Sep 17 00:00:00 2001 From: Tianyi Tao <146603607+tianyeeT@users.noreply.github.com> Date: Mon, 27 May 2024 22:29:17 +0800 Subject: [PATCH 3/7] Update files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --- .../aria/aria_screen_reader_implementors_guide/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md b/files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md index 7fb036a36424d5..3153b7c180e7f3 100644 --- a/files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md +++ b/files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md @@ -8,6 +8,7 @@ l10n: {{AccessibilitySidebar}} ## 实时区域 + 这只是一个指南。实时区域标记是一个相对开放于解释的复杂领域。以下旨在提供实现指导，以尊重屏幕阅读器开发者尝试不同方法的需求。其目的是在提供有关如何使用标记的预期含义的有用指导的同时，支持实时区域作为屏幕阅读器创新和竞争的领域之间达成平衡。 ### 解释 WAI-ARIA 实时区域标记 From f173ec4d907b68b593ab115e8f507c0f1efa39e4 Mon Sep 17 00:00:00 2001 From: Tianyi Tao <146603607+tianyeeT@users.noreply.github.com> Date: Mon, 27 May 2024 22:29:24 +0800 Subject: [PATCH 4/7] Update files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --- .../aria/aria_screen_reader_implementors_guide/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md b/files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md index 3153b7c180e7f3..563fdbf7d40249 100644 --- a/files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md +++ b/files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md @@ -12,6 +12,7 @@ l10n: 这只是一个指南。实时区域标记是一个相对开放于解释的复杂领域。以下旨在提供实现指导，以尊重屏幕阅读器开发者尝试不同方法的需求。其目的是在提供有关如何使用标记的预期含义的有用指导的同时，支持实时区域作为屏幕阅读器创新和竞争的领域之间达成平衡。 ### 解释 WAI-ARIA 实时区域标记 + 1. 实时更改是提示：一般情况下，实时区域标记是由作者提供的提示，辅助技术可以允许全局、站点甚至区域特定的设置，以及启发式方法来帮助处理没有 WAI-ARIA 提示的页面上的实时更改。 2. 可选择地，如果用户配置了第二个硬件通道，则创建第二个额外的队列：如果有两个用于呈现的通道（例如文本到语音和点字显示），则可以维护两个队列以实现并行呈现。通道可以根据角色或礼貌度进行用户配置，用于呈现实时区域。 3. 忙碌区域：在带有 aria-busy="true" 标记的区域中的任何更改都不应在清除该属性之前添加到队列中。 From cf2b6c0d53c1814ab9d53771ed7b4903ae283a9f Mon Sep 17 00:00:00 2001 From: Tianyi Tao <146603607+tianyeeT@users.noreply.github.com> Date: Mon, 27 May 2024 22:29:35 +0800 Subject: [PATCH 5/7] Update files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --- .../aria/aria_screen_reader_implementors_guide/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md b/files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md index 563fdbf7d40249..775d460acb2996 100644 --- a/files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md +++ b/files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md @@ -22,6 +22,7 @@ l10n: 7. 在呈现更改时包括标签：如果更改发生在具有某种语义标签的内容中，请朗读标签。这对于数据单元格中的更改尤其重要，其中列和行标题提供了重要的上下文信息。 ### 设置和启发式方法的想法 + 1. 允许使用不同的语音（在文本到语音中）或其他不同的呈现特征来区分实时更改。 2. 当没有 WAI-ARIA 标记时，除非用户将所有实时更改配置为关闭，否则自动呈现一些更改。例如，在用户自己的输入的上下文中自动朗读由用户输入引起的更改。 3. 允许全局设置关闭实时更改的呈现，呈现所有实时更改，使用标记，或者是"智能"（使用启发式方法）。 From e32200f5e5bd89c1bbecaab9cd0c786d166e6249 Mon Sep 17 00:00:00 2001 From: Tianyi Tao <146603607+tianyeeT@users.noreply.github.com> Date: Tue, 4 Jun 2024 10:47:39 +0800 Subject: [PATCH 6/7] Apply suggestions from code review Co-authored-by: Jason Ren <40999116+jasonren0403@users.noreply.github.com> --- .../aria/aria_screen_reader_implementors_guide/index.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md b/files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md index 775d460acb2996..19dd1170631e8c 100644 --- a/files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md +++ b/files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md @@ -16,13 +16,13 @@ l10n: 1. 实时更改是提示：一般情况下，实时区域标记是由作者提供的提示，辅助技术可以允许全局、站点甚至区域特定的设置，以及启发式方法来帮助处理没有 WAI-ARIA 提示的页面上的实时更改。 2. 可选择地，如果用户配置了第二个硬件通道，则创建第二个额外的队列：如果有两个用于呈现的通道（例如文本到语音和点字显示），则可以维护两个队列以实现并行呈现。通道可以根据角色或礼貌度进行用户配置，用于呈现实时区域。 3. 忙碌区域：在带有 aria-busy="true" 标记的区域中的任何更改都不应在清除该属性之前添加到队列中。 -4. 礼貌度（`aria-live` 或来源于[role](/zh-CN/docs/Web/Accessibility/ARIA/Roles)）优先级最高：根据 aria-live 属性或从角色继承的礼貌度级别将项目添加到队列中（例如，[role="log"](/zh-CN/docs/Web/Accessibility/ARIA/Roles/log_role) 默认为礼貌）。断言项目优先于礼貌度级别。另外，实现可能选择清除更礼貌的项目，例如，断言项目会清除队列中的任何礼貌项目。 -5. 时间次之：根据事件发生的时间顺序（较早的事件优先），对具有相同礼貌度级别的项目进行排序。以发生顺序的顺序呈现相同礼貌度级别的项目。 -6. 具有多个更改的原子（`aria-atomic="true"`）区域不应重复呈现相同的内容。随着为原子区域添加到队列的新事件，删除同一区域的早期事件。可能希望在呈现原子区域更改之前至少有一个微小的超时，以避免在彼此之后快速发生的两个更改中两次呈现该区域。 +4. 礼貌度（`aria-live` 或来源于[角色](/zh-CN/docs/Web/Accessibility/ARIA/Roles)）优先级最高：根据 aria-live 属性或从角色继承的礼貌度级别将项目添加到队列中（例如，[role="log"](/zh-CN/docs/Web/Accessibility/ARIA/Roles/log_role) 默认为礼貌）。断言项目优先于礼貌度级别。另外，实现可能选择清除更礼貌的项目，例如，断言项目会清除队列中的任何礼貌项目。 +5. 时间次之：根据事件发生的时间顺序（较早的事件优先），对具有相同礼貌度级别的项目进行排序。按照最先出现的顺序排列相同礼貌等级的项目。 +6. 具有多个更改的原子（`aria-atomic="true"`）区域不应重复呈现相同的内容。当一个原子区域的新事件被添加到队列中时，就会移除同一区域的早期事件。可能希望在呈现原子区域更改之前至少有一个微小的超时，以避免在彼此之后快速发生的两个更改中两次呈现该区域。 7. 在呈现更改时包括标签：如果更改发生在具有某种语义标签的内容中，请朗读标签。这对于数据单元格中的更改尤其重要，其中列和行标题提供了重要的上下文信息。 ### 设置和启发式方法的想法 1. 允许使用不同的语音（在文本到语音中）或其他不同的呈现特征来区分实时更改。 2. 当没有 WAI-ARIA 标记时，除非用户将所有实时更改配置为关闭，否则自动呈现一些更改。例如，在用户自己的输入的上下文中自动朗读由用户输入引起的更改。 -3. 允许全局设置关闭实时更改的呈现，呈现所有实时更改，使用标记，或者是"智能"（使用启发式方法）。 +3. 允许进行全局设置，以关闭显示实时更改、显示所有实时更改、使用标记或使用“智能模式”（使用启发式方法）。 From a457e2c78662aca6b83faf37055c3190cdf5743f Mon Sep 17 00:00:00 2001 From: Tianyi Tao <146603607+tianyeeT@users.noreply.github.com> Date: Tue, 4 Jun 2024 10:49:35 +0800 Subject: [PATCH 7/7] =?UTF-8?q?translate=20`implementation`=20into=20`?= =?UTF-8?q?=E5=AE=9E=E7=8E=B0`?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../aria/aria_screen_reader_implementors_guide/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md b/files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md index 19dd1170631e8c..4f1ecdf1c7e7fa 100644 --- a/files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md +++ b/files/zh-cn/web/accessibility/aria/aria_screen_reader_implementors_guide/index.md @@ -1,5 +1,5 @@ --- -title: ARIA 屏幕阅读器实施指南 +title: ARIA 屏幕阅读器实现指南 slug: Web/Accessibility/ARIA/ARIA_Screen_Reader_Implementors_Guide l10n: sourceCommit: 019ca5c9ce641bfa02825e1ba0444f35dfb646cc