From 338b371d11accbb8731a8e4ad358cd7637979a3d Mon Sep 17 00:00:00 2001 From: Tianyi Tao <146603607+tianyeeT@users.noreply.github.com> Date: Tue, 28 May 2024 22:02:48 +0800 Subject: [PATCH 1/5] [zh-cn]: update the translation of `mobile_accessibility` --- .../mobile_accessibility_checklist/index.md | 29 +++++++++++++------ 1 file changed, 20 insertions(+), 9 deletions(-) diff --git a/files/zh-cn/web/accessibility/mobile_accessibility_checklist/index.md b/files/zh-cn/web/accessibility/mobile_accessibility_checklist/index.md index 17dc19cf804473..cbfcb10dfb377b 100644 --- a/files/zh-cn/web/accessibility/mobile_accessibility_checklist/index.md +++ b/files/zh-cn/web/accessibility/mobile_accessibility_checklist/index.md @@ -1,6 +1,8 @@ --- title: 移动无障碍清单 slug: Web/Accessibility/Mobile_accessibility_checklist +l10n: + sourceCommit: 019ca5c9ce641bfa02825e1ba0444f35dfb646cc --- {{AccessibilitySidebar}} @@ -9,15 +11,13 @@ slug: Web/Accessibility/Mobile_accessibility_checklist ## 颜色 -- 颜色对比度**必须**遵循 [WCAG 2.0](http://www.w3.org/TR/WCAG/) AA 等级需求: +- 颜色对比度**必须**遵循 [WCAG 2.1 AA 等级需求](https://www.w3.org/TR/WCAG/#contrast-minimum): - 普通文本的对比率为 4.5:1(小于 18 磅或黑体 14 磅) - 大文本对比率为 3:1(大于等于 18 磅或黑体 14 磅)【译者注:字体单位为 point、PT】 - 颜色传递的信息,**必须**也通过其他方式标明(例如,链接文本中的下划线) -> **备注:** Jon Snook 开发的 [颜色对比度检查器 - Colour Contrast Checker](http://snook.ca/technical/colour_contrast/colour.html) 可以轻松检查前景和背景的对比度。同样,[Tanaguru Contrast-Finder](http://contrast-finder.tanaguru.com/) 这个工具能做类似的检查,并且会推荐你考虑使用类似的更好的对比度 - ## 可视化 - **不**使用用于隐藏内容的技巧处理视觉效果,例如,不透明度为零,z-index 规则,离屏位置。 @@ -43,11 +43,18 @@ slug: Web/Accessibility/Mobile_accessibility_checklist - 如果上面的特性不适用,使用恰当的[ARIA Properties](http://www.w3.org/WAI/PF/aria/states_and_properties#global_states_header),比如 `aria-label`, `aria-labelledby`, 或 `aria-describedby`. - **必须**避免文本图像。 +- 所有带有可见文本(或文本图片)作为标签的用户界面组件必须在组件的编程[名称](https://www.w3.org/TR/WCAG21/#dfn-name)中提供相同的文本。见 [WCAG 2.1: 名称中的标签](https://www.w3.org/WAI/WCAG21/Understanding/label-in-name.html)。 - 所有的表单控件**必须**有标签 ({{ htmlelement("label") }} elements) ,以便于读屏用户的使用。 ## 状态处理 -- 标准控件,如单选按钮和复选是通过操作系统处理的,而其他自定义控件的状态改变需要通过 [ARIA States](http://www.w3.org/TR/wai-aria/states_and_properties#attrs_widgets_header) ,如 `aria-checked`, `aria-disabled`, `aria-selected`, `aria-expanded`,和 `aria-pressed`. +- 标准控件,如单选按钮和复选是通过操作系统处理的,而其他自定义控件的状态改变需要通过 [ARIA States](http://www.w3.org/TR/wai-aria/states_and_properties#attrs_widgets_header) ,如 `aria-checked`, `aria-disabled`, `aria-selected`, `aria-expanded`,和 `aria-pressed`。 + +## 方向 + +- 内容不应仅限于单一方向,如纵向或横向,除非必要。见 [WCAG 2.1:方向](https://www.w3.org/WAI/WCAG21/Understanding/orientation.html) + + - 方向是必要的例如在钢琴应用程序或银行支票。 ## General Guidelines 常规指南 @@ -61,10 +68,14 @@ slug: Web/Accessibility/Mobile_accessibility_checklist

Low level heading

``` -- 应使用 [ARIA Landmark Roles](http://www.w3.org/TR/wai-aria/roles#landmark_roles_header) 描述应用或文档的结构,如 `banner`, `complementary`, `contentinfo`, `main`, `navigation`, `search`. -- 触摸事件处理器,只能通过 `touchend` 事件触发。 -- 触摸目标必须足够大,方便用户交互 (参考 [BBC Mobile Accessibility Guidelines](http://www.bbc.co.uk/guidelines/futuremedia/accessibility/mobile/design/touch-target-size) 关于触摸目标尺寸的指南) +- 应使用 [ARIA Landmark Roles](https://www.washington.edu/accessibility/websites/regions/) 描述应用或文档的结构,如 `banner`, `complementary`, `contentinfo`, `main`, `navigation`, `search`. +- 对于触摸事件,以下至少有一项必须为真([WCAG 2.1:指针取消](https://www.w3.org/WAI/WCAG21/Understanding/pointer-cancellation.html)): + + - 不应使用按下事件来触发任何操作 + - 操作在释放事件上触发,并提供中止操作的选项,在其完成之前或提供撤消操作的选项 + - 松开事件将撤消在按下事件上触发的任何操作 + - 在按下事件上触发操作是必要的。例如,玩游戏或钢琴应用程序。 -> **备注:** [Tanaguru's automated accessibility testing service](http://www.tanaguru.com/) 提供一个有效的方法,排查网页上的,或者是可安装的 Web 应用中无障碍问题(如,Firefox OS)。[tanaguru.org](http://tanaguru.org/),你可以参与该项目或者发现更多技术实现。 +- 触摸目标必须足够大,方便用户交互 (参考 [BBC Mobile Accessibility Guidelines](http://www.bbc.co.uk/guidelines/futuremedia/accessibility/mobile/design/touch-target-size) 关于触摸目标尺寸的指南) -> **备注:** The 该文档的最初版本 - [original version of this document](http://yzen.github.io/firefoxos/2014/04/30/mobile-accessibility-checklist.html) 是由 [Yura Zenevich](http://yzen.github.io/) 完成。 +> **备注:** 该文档的[最初版本](https://yzen.github.io/firefoxos/2014/04/30/mobile-accessibility-checklist.html) 是由 [Yura Zenevich](https://yzen.github.io/) 完成。 From cfaf568683dd3b37681937483bbd5a03a569e5ce Mon Sep 17 00:00:00 2001 From: Tianyi Tao <146603607+tianyeeT@users.noreply.github.com> Date: Wed, 5 Jun 2024 14:15:01 +0800 Subject: [PATCH 2/5] Apply suggestions from code review Co-authored-by: Jason Ren <40999116+jasonren0403@users.noreply.github.com> --- .../mobile_accessibility_checklist/index.md | 24 +++++++++---------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/files/zh-cn/web/accessibility/mobile_accessibility_checklist/index.md b/files/zh-cn/web/accessibility/mobile_accessibility_checklist/index.md index cbfcb10dfb377b..a3e7738e57efee 100644 --- a/files/zh-cn/web/accessibility/mobile_accessibility_checklist/index.md +++ b/files/zh-cn/web/accessibility/mobile_accessibility_checklist/index.md @@ -14,13 +14,13 @@ l10n: - 颜色对比度**必须**遵循 [WCAG 2.1 AA 等级需求](https://www.w3.org/TR/WCAG/#contrast-minimum): - 普通文本的对比率为 4.5:1(小于 18 磅或黑体 14 磅) - - 大文本对比率为 3:1(大于等于 18 磅或黑体 14 磅)【译者注:字体单位为 point、PT】 + - 大文本对比率为 3:1(大于等于 18 磅或黑体 14 磅) -- 颜色传递的信息,**必须**也通过其他方式标明(例如,链接文本中的下划线) +- 颜色传递的信息,必须也通过其他方式标明(例如,链接文本中的下划线) ## 可视化 -- **不**使用用于隐藏内容的技巧处理视觉效果,例如,不透明度为零,z-index 规则,离屏位置。 +- 内容隐藏技术(如零不透明度、z-index 顺序和离屏位置)不得仅用于处理可见性。 - 当前可见的屏幕之外的内容,**必须**是不可见的。(特别是单一页面应用中包含多个卡片选项): - **使用** `hidden` 特性或 `visibility` 或 `display` 样式属性。 @@ -42,21 +42,21 @@ l10n: - 恰当的位置使用 _alt_ 和 _title_(请参考 Steve Faulkner 的帖子 - 关于 [Using the HTML title attribute](http://blog.paciellogroup.com/2013/01/using-the-html-title-attribute-updated/) 。) - 如果上面的特性不适用,使用恰当的[ARIA Properties](http://www.w3.org/WAI/PF/aria/states_and_properties#global_states_header),比如 `aria-label`, `aria-labelledby`, 或 `aria-describedby`. -- **必须**避免文本图像。 -- 所有带有可见文本(或文本图片)作为标签的用户界面组件必须在组件的编程[名称](https://www.w3.org/TR/WCAG21/#dfn-name)中提供相同的文本。见 [WCAG 2.1: 名称中的标签](https://www.w3.org/WAI/WCAG21/Understanding/label-in-name.html)。 -- 所有的表单控件**必须**有标签 ({{ htmlelement("label") }} elements) ,以便于读屏用户的使用。 +- 必须避免使用文本图像。 +- 所有带有可见文本(或文本图片)作为标签的用户界面组件必须在组件的编程[名称](https://www.w3.org/TR/WCAG21/#dfn-name)中提供相同的文本。见 [WCAG 2.1:名称中的标签](https://www.w3.org/WAI/WCAG21/Understanding/label-in-name.html)。 +- 所有的表单控件必须有标签({{ htmlelement("label") }} 元素),以便于屏幕阅读器用户的使用。 ## 状态处理 -- 标准控件,如单选按钮和复选是通过操作系统处理的,而其他自定义控件的状态改变需要通过 [ARIA States](http://www.w3.org/TR/wai-aria/states_and_properties#attrs_widgets_header) ,如 `aria-checked`, `aria-disabled`, `aria-selected`, `aria-expanded`,和 `aria-pressed`。 +- 单选按钮和复选框等标准控件是由操作系统处理的,而其他自定义控件的状态改变需要通过 [ARIA 状态](http://www.w3.org/TR/wai-aria/states_and_properties#attrs_widgets_header),如 `aria-checked`、`aria-disabled`、`aria-selected`、`aria-expanded` 和 `aria-pressed`。 ## 方向 - 内容不应仅限于单一方向,如纵向或横向,除非必要。见 [WCAG 2.1:方向](https://www.w3.org/WAI/WCAG21/Understanding/orientation.html) - - 方向是必要的例如在钢琴应用程序或银行支票。 + - 例如,钢琴应用程序和银行支票都需要一定的方向。 -## General Guidelines 常规指南 +## 通用指南 - 应用必须提供标题。【译者注:此处的标题为 title】 - 标题**不能**破坏层次结构。【译者注:此处的标题为 headings】 @@ -68,7 +68,7 @@ l10n:

Low level heading

``` -- 应使用 [ARIA Landmark Roles](https://www.washington.edu/accessibility/websites/regions/) 描述应用或文档的结构,如 `banner`, `complementary`, `contentinfo`, `main`, `navigation`, `search`. +- 应使用 [ARIA 地标角色](https://www.washington.edu/accessibility/websites/regions/) 描述应用或文档的结构,如 `banner`、`complementary`、`contentinfo`、`main`、`navigation` 和 `search`。 - 对于触摸事件,以下至少有一项必须为真([WCAG 2.1:指针取消](https://www.w3.org/WAI/WCAG21/Understanding/pointer-cancellation.html)): - 不应使用按下事件来触发任何操作 @@ -76,6 +76,6 @@ l10n: - 松开事件将撤消在按下事件上触发的任何操作 - 在按下事件上触发操作是必要的。例如,玩游戏或钢琴应用程序。 -- 触摸目标必须足够大,方便用户交互 (参考 [BBC Mobile Accessibility Guidelines](http://www.bbc.co.uk/guidelines/futuremedia/accessibility/mobile/design/touch-target-size) 关于触摸目标尺寸的指南) +- 触摸目标必须足够大,方便用户交互(参考 [BBC 移动端无障碍指南](http://www.bbc.co.uk/guidelines/futuremedia/accessibility/mobile/design/touch-target-size)关于触摸目标尺寸的指南) -> **备注:** 该文档的[最初版本](https://yzen.github.io/firefoxos/2014/04/30/mobile-accessibility-checklist.html) 是由 [Yura Zenevich](https://yzen.github.io/) 完成。 +> **备注:** 该文档的[最初版本](https://yzen.github.io/firefoxos/2014/04/30/mobile-accessibility-checklist.html) 由 [Yura Zenevich](https://yzen.github.io/) 完成。 From cda740bcdd601db29229772973e37afa4a045f55 Mon Sep 17 00:00:00 2001 From: Tianyi Tao <146603607+tianyeeT@users.noreply.github.com> Date: Wed, 5 Jun 2024 14:26:32 +0800 Subject: [PATCH 3/5] Update index.md --- .../mobile_accessibility_checklist/index.md | 32 +++++++++---------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/files/zh-cn/web/accessibility/mobile_accessibility_checklist/index.md b/files/zh-cn/web/accessibility/mobile_accessibility_checklist/index.md index a3e7738e57efee..5f8c82f81e5aa3 100644 --- a/files/zh-cn/web/accessibility/mobile_accessibility_checklist/index.md +++ b/files/zh-cn/web/accessibility/mobile_accessibility_checklist/index.md @@ -21,26 +21,26 @@ l10n: ## 可视化 - 内容隐藏技术(如零不透明度、z-index 顺序和离屏位置)不得仅用于处理可见性。 -- 当前可见的屏幕之外的内容,**必须**是不可见的。(特别是单一页面应用中包含多个卡片选项): +- 当前可见的屏幕之外的内容,必须是不可见的(特别是单一页面应用中包含多个卡片选项): - - **使用** `hidden` 特性或 `visibility` 或 `display` 样式属性。 - - 除非不可避免,**不应该**使用 `aria-hidden` 特性。 + - 使用 `hidden` 特性或 `visibility` 或 `display` 样式属性。 + - 除非不可避免,不应该使用 `aria-hidden` 特性。 ## 焦点 -- 所有可激活元素**必须**可被聚焦: +- 所有可激活元素必须可被聚焦: - 标准控件,如链接、按钮、表单域默认可被聚焦。 - - 非标准控件**必须**分配给它们一个适当的 [ARIA Role](http://www.w3.org/TR/wai-aria/roles) 如 `button`,`link` 或者 `checkbox`。 + - 非标准控件必须分配给它们一个适当的 [ARIA 角色](http://www.w3.org/TR/wai-aria/roles) 如 `button`、`link` 或 `checkbox`。 - 焦点应该是有逻辑顺序,且方式一致。 ## 文本等效 -- 应用中,每个展示的非文本元素都**必须**提供等效文本。 +- 应用中,每个展示的非文本元素都必须提供等效文本。 - - 恰当的位置使用 _alt_ 和 _title_(请参考 Steve Faulkner 的帖子 - 关于 [Using the HTML title attribute](http://blog.paciellogroup.com/2013/01/using-the-html-title-attribute-updated/) 。) - - 如果上面的特性不适用,使用恰当的[ARIA Properties](http://www.w3.org/WAI/PF/aria/states_and_properties#global_states_header),比如 `aria-label`, `aria-labelledby`, 或 `aria-describedby`. + - 恰当的位置使用 _alt_ 和 _title_(请参考 Steve Faulkner 关于[使用 HTML title 特性](https://www.tpgi.com/using-the-html-title-attribute-updated/) 的帖子。) + - 如果上面的特性不适用,使用恰当的[ARIA 状态与属性](https://www.w3.org/TR/wai-aria-1.1/#state_prop_def),比如 `aria-label`、`aria-labelledby` 或 `aria-describedby`。 - 必须避免使用文本图像。 - 所有带有可见文本(或文本图片)作为标签的用户界面组件必须在组件的编程[名称](https://www.w3.org/TR/WCAG21/#dfn-name)中提供相同的文本。见 [WCAG 2.1:名称中的标签](https://www.w3.org/WAI/WCAG21/Understanding/label-in-name.html)。 @@ -48,7 +48,7 @@ l10n: ## 状态处理 -- 单选按钮和复选框等标准控件是由操作系统处理的,而其他自定义控件的状态改变需要通过 [ARIA 状态](http://www.w3.org/TR/wai-aria/states_and_properties#attrs_widgets_header),如 `aria-checked`、`aria-disabled`、`aria-selected`、`aria-expanded` 和 `aria-pressed`。 +- 单选按钮和复选框等标准控件是由操作系统处理的,而其他自定义控件的状态改变需要通过 [ARIA 状态](https://www.w3.org/TR/wai-aria-1.1/#state_prop_def),如 `aria-checked`、`aria-disabled`、`aria-selected`、`aria-expanded` 和 `aria-pressed`。 ## 方向 @@ -58,14 +58,14 @@ l10n: ## 通用指南 -- 应用必须提供标题。【译者注:此处的标题为 title】 -- 标题**不能**破坏层次结构。【译者注:此处的标题为 headings】 +- 应用(title)必须提供标题。 +- 标题(heading)不能破坏层次结构。 ```html -

Top level heading

-

Secondary heading

-

Another secondary heading

-

Low level heading

+

一级标题

+ +

另一个二级标题

+

三级标题

``` - 应使用 [ARIA 地标角色](https://www.washington.edu/accessibility/websites/regions/) 描述应用或文档的结构,如 `banner`、`complementary`、`contentinfo`、`main`、`navigation` 和 `search`。 @@ -78,4 +78,4 @@ l10n: - 触摸目标必须足够大,方便用户交互(参考 [BBC 移动端无障碍指南](http://www.bbc.co.uk/guidelines/futuremedia/accessibility/mobile/design/touch-target-size)关于触摸目标尺寸的指南) -> **备注:** 该文档的[最初版本](https://yzen.github.io/firefoxos/2014/04/30/mobile-accessibility-checklist.html) 由 [Yura Zenevich](https://yzen.github.io/) 完成。 +> **备注:** 该文档的[最初版本](https://yzen.github.io/firefoxos/2014/04/30/mobile-accessibility-checklist.html)由 [Yura Zenevich](https://yzen.github.io/) 完成。 From 6aece42ff129deaf95ed4daf445764042306367f Mon Sep 17 00:00:00 2001 From: Tianyi Tao <146603607+tianyeeT@users.noreply.github.com> Date: Wed, 5 Jun 2024 14:40:01 +0800 Subject: [PATCH 4/5] fix --- .../web/accessibility/mobile_accessibility_checklist/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/zh-cn/web/accessibility/mobile_accessibility_checklist/index.md b/files/zh-cn/web/accessibility/mobile_accessibility_checklist/index.md index 5f8c82f81e5aa3..198709d4359757 100644 --- a/files/zh-cn/web/accessibility/mobile_accessibility_checklist/index.md +++ b/files/zh-cn/web/accessibility/mobile_accessibility_checklist/index.md @@ -63,7 +63,7 @@ l10n: ```html

一级标题

- +

二级标题

另一个二级标题

三级标题

``` From 1b8f14250b0548f3a6f52f0b688e16b14412e1bf Mon Sep 17 00:00:00 2001 From: Jason Ren <40999116+jasonren0403@users.noreply.github.com> Date: Thu, 6 Jun 2024 10:02:50 +0800 Subject: [PATCH 5/5] minor fixes --- .../mobile_accessibility_checklist/index.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/files/zh-cn/web/accessibility/mobile_accessibility_checklist/index.md b/files/zh-cn/web/accessibility/mobile_accessibility_checklist/index.md index 198709d4359757..28e57ce205749e 100644 --- a/files/zh-cn/web/accessibility/mobile_accessibility_checklist/index.md +++ b/files/zh-cn/web/accessibility/mobile_accessibility_checklist/index.md @@ -11,7 +11,7 @@ l10n: ## 颜色 -- 颜色对比度**必须**遵循 [WCAG 2.1 AA 等级需求](https://www.w3.org/TR/WCAG/#contrast-minimum): +- 颜色对比度必须遵循 [WCAG 2.1 AA 等级需求](https://www.w3.org/TR/WCAG/#contrast-minimum): - 普通文本的对比率为 4.5:1(小于 18 磅或黑体 14 磅) - 大文本对比率为 3:1(大于等于 18 磅或黑体 14 磅) @@ -21,9 +21,9 @@ l10n: ## 可视化 - 内容隐藏技术(如零不透明度、z-index 顺序和离屏位置)不得仅用于处理可见性。 -- 当前可见的屏幕之外的内容,必须是不可见的(特别是单一页面应用中包含多个卡片选项): +- 当前可见的屏幕之外的内容,必须*确实*是不可见的(特别是单一页面应用中的多个*卡片*): - - 使用 `hidden` 特性或 `visibility` 或 `display` 样式属性。 + - 使用 `hidden` 特性或 `visibility`、`display` 样式属性。 - 除非不可避免,不应该使用 `aria-hidden` 特性。 ## 焦点 @@ -31,16 +31,16 @@ l10n: - 所有可激活元素必须可被聚焦: - 标准控件,如链接、按钮、表单域默认可被聚焦。 - - 非标准控件必须分配给它们一个适当的 [ARIA 角色](http://www.w3.org/TR/wai-aria/roles) 如 `button`、`link` 或 `checkbox`。 + - 非标准控件必须为它们分配一个适当的 [ARIA 角色](http://www.w3.org/TR/wai-aria/roles),如 `button`、`link` 或 `checkbox`。 -- 焦点应该是有逻辑顺序,且方式一致。 +- 焦点应该有逻辑顺序,且方式一致。 ## 文本等效 - 应用中,每个展示的非文本元素都必须提供等效文本。 - 恰当的位置使用 _alt_ 和 _title_(请参考 Steve Faulkner 关于[使用 HTML title 特性](https://www.tpgi.com/using-the-html-title-attribute-updated/) 的帖子。) - - 如果上面的特性不适用,使用恰当的[ARIA 状态与属性](https://www.w3.org/TR/wai-aria-1.1/#state_prop_def),比如 `aria-label`、`aria-labelledby` 或 `aria-describedby`。 + - 如果上面的特性不适用,使用恰当的 [ARIA 状态与属性](https://www.w3.org/TR/wai-aria-1.1/#state_prop_def),比如 `aria-label`、`aria-labelledby` 或 `aria-describedby`。 - 必须避免使用文本图像。 - 所有带有可见文本(或文本图片)作为标签的用户界面组件必须在组件的编程[名称](https://www.w3.org/TR/WCAG21/#dfn-name)中提供相同的文本。见 [WCAG 2.1:名称中的标签](https://www.w3.org/WAI/WCAG21/Understanding/label-in-name.html)。 @@ -52,13 +52,13 @@ l10n: ## 方向 -- 内容不应仅限于单一方向,如纵向或横向,除非必要。见 [WCAG 2.1:方向](https://www.w3.org/WAI/WCAG21/Understanding/orientation.html) +- 除非必要,否则不应将内容限制在单一方向,如纵向或横向。见 [WCAG 2.1:方向](https://www.w3.org/WAI/WCAG21/Understanding/orientation.html) - 例如,钢琴应用程序和银行支票都需要一定的方向。 ## 通用指南 -- 应用(title)必须提供标题。 +- 应用必须提供标题(title)。 - 标题(heading)不能破坏层次结构。 ```html @@ -68,7 +68,7 @@ l10n:

三级标题

``` -- 应使用 [ARIA 地标角色](https://www.washington.edu/accessibility/websites/regions/) 描述应用或文档的结构,如 `banner`、`complementary`、`contentinfo`、`main`、`navigation` 和 `search`。 +- 应使用 [ARIA 地标角色](https://www.washington.edu/accessibility/websites/regions/)描述应用或文档的结构,如 `banner`、`complementary`、`contentinfo`、`main`、`navigation` 和 `search`。 - 对于触摸事件,以下至少有一项必须为真([WCAG 2.1:指针取消](https://www.w3.org/WAI/WCAG21/Understanding/pointer-cancellation.html)): - 不应使用按下事件来触发任何操作