` or `
`) 那么必须使用`tabindex` 属性来使按钮可聚焦。
+`button` 角色可以和 [`aria-pressed`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-pressed) 发生一起使用,以[创建切换按钮](#toggle_buttons)。
-按钮可以由鼠标用户和键盘用户操作。对于原生 HTML `
+```
+
+由于 `button` 的子元素都是 presentation,因此相当于以下的代码:
+
+```html
+按钮的标题
+```
+
+从辅助技术的视角来看,这个标题不存在,因为前面的代码片段在 [辅助功能树](/zh-CN/docs/Glossary/Accessibility_tree) 中相当于以下内容:
+
+```html
+按钮的标题
+```
+
+### 关联的 ARIA 角色、状态和属性
+
+- [`aria-pressed`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-pressed)
+ - : `aria-pressed` 属性定义的按钮是否为切换按钮。此值描述了按钮的状态。值包括 `aria-pressed="false"`(按钮还没有被按下)、`aria-pressed="true"` (按钮当前已被按下)和 `aria-pressed="mixed"` (按钮被视为部分按下)。如果此属性被忽略,或者设置为默认值 `aria-pressed="undefined"`,那么元素不支持被按下。
+- [`aria-expanded`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-expanded)
+ - : 如果按钮控制了其他元素的分组,`aria-expanded` 状态指示了被控制的分组当前是被展开还是折叠。如果按钮有设置了 `aria-expanded="false"`,那么分组当前没有开,如果被展开了,则按钮会有 `aria-expanded="undefined"`,如果属性被忽略,则是不可展开。
+
+
+### 基本的按钮
-**Warning:** 把给一个链接标记为按钮角色的链接时要谨慎。按钮将使用 Space or Enter 键触发,而链接被期望使用 Enter 键触发。换句话说,当链接被用来作为按钮的时候,仅仅添加`role="button"`是不够的。还需要添加一个 key 事件处理程序来侦听 Space 键,以便与原生按钮保持一致。
+Buttons should always have an accessible name. For most buttons, this name will be the same as the text inside the button, between the opening and closing tags. In some cases, for example buttons represented by icons, the accessible name may be provided from the [`aria-label`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-label) or [`aria-labelledby`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-labelledby) attributes.
-## 可切换的按钮
+## 切换按钮
-使用`role="button"`的一个优点是它允许创建切换按钮。一个切换按钮可以有两个状态:pressed,not pressed。除了 `button`角色之外,按钮是否为切换按钮,也可以用`aria-pressed`的属性来表示。
+切换按钮通常有两种状态:按下、没有按下,第三个混合的状是指,切换按钮控制了其他的元素,例如其他的切换按钮或者复选框,而不共享同一个值。按钮是否被按下可以由 `button` 角色(如果元素还不是原生的 button 元素)加上 [`aria-pressed`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-pressed) 表示:
-- 如果没有 `aria-pressed`表明这不是一个切换按钮。
-- 如果 `aria-pressed="false"` 表示这个按钮当前是 not pressed 的。
-- 如果 `aria-pressed="true"` 表示这个按钮当前是 pressed 的。
-- 如果 `aria-pressed="mixed"` 则认为按钮部分是 partially pressed 的。
+- 如果没有 `aria-pressed`,说明这不是一个切换按钮。
+- 如果 `aria-pressed="false"`,说明这个按钮当前没有被按下。
+- 如果 `aria-pressed="true"`。说明这个按钮当前已被按下。
+- 如果 `aria-pressed="mixed"`,说明这个按钮被认为是部分按下的。
-## Labeling buttons
+As an example, the mute button on an audio player labeled "mute" could indicate that sound is muted by setting the `aria-pressed` state true. The label of a toggle button should not change when its state changes. In our example the label remains "Mute" with a screen reader reading "Mute toggle button pressed" or "Mute toggle button not pressed" depending on the value of `aria-pressed`. If the design were to call for the button label to change from "Mute" to "Unmute," a toggle button would not be appropriate, so the `aria-pressed` attribute would be omitted.
-按钮应该总是有一个可访问的名称。对于大多数按钮,这个名称将与按钮中的文本相同。在某些情况下,例如图标按钮,可通过 [`aria-label`](/zh-CN/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-label_attribute) 或 [`aria-labelledby`](/zh-CN/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-labelledby_attribute) 属性提供可访问的名称。
+### 键盘交互
-## 对用户代理和辅助技术的可能影响
+| 按键 | 功能 |
+| ---------------- | --------------------- |
+| Enter | 激活按钮。 |
+| Space | 激活按钮。 |
-当使用 `button` 角色时,用户代理应该将该元素公开为操作系统的易访问性 API 中的按钮控件。屏幕阅读器应该将元素声明为一个按钮并描述其可访问的名称。语音识别软件应该可以通过说:"点击"+ 按钮的可访问的 name 就能激活这个按钮。
+Following button activation, focus is set depending on the type of action the button performs. For example, if clicking the button opens a dialog, the focus should move to the dialog. If the button closes a dialog, focus should return to the button that opened the dialog unless the function performed in the dialog context logically leads to a different element. If the button alters the current context, such as muting and unmuting an audio file, then focus typically remains on the button.
-> **备注:** 关于辅助技术如何处理这种技术,意见可能有所不同。上面所提供的信息是其中之一,因此并非规范。
-## Examples
+### Required JavaScript Features
-### ARIA Basic Button
+#### Required event handlers
-在下面的代码片段中,一个 span 元素已经被赋予了按钮角色。由于使用的是 `` 元素,因此需要提供 `tabindex` 属性使按钮的可聚焦并成为 tab 顺序流中的一部分。注意,这段代码提供了 CSS 样式,以使 ``元素看起来像一个按钮, `handleBtnClick` 和`handleBtnKeyPress` 是事件处理程序,当鼠标单击、 Space or Enter 被按下时,执行该按钮的操作。
+Buttons can be operated by mouse, touch, and keyboard users. For native HTML `` elements, the button's `onclick` event fires for mouse clicks and when the user presses Space or Enter while the button has focus. But if another tag is used to create a button, the `onclick` event only fires when clicked by the mouse cursor, even if `role="button"` is used. Because of this, separate key event handlers must be added to the element so that the button is be triggered when the Space or Enter key is pressed.
+
+- `onclick`
+ - : Handles the event raised when the button is activated using a mouse click or touch event.
+- `onKeyDown`
+ - : Handles the event raised when the button is activated using the Enter or Space key on the keyboard. (Note not the [deprecated onKeyPress](/zh-CN/docs/Web/API/Element/keypress_event))
+
+## 示例
+
+### 基本按钮示例
+
+在这个例子中,span 元素有个 `button` 角色。由于使用了 `` 元素,需要使用 `tabindex` 属性以使得按钮可聚焦,并成为页面的 tab 顺序的一部分。还有包含 CSS 样式,以使用这个 `` 元素看上去像是个按钮,并在按钮有焦点时,提供了视觉呈现。
+
+`handleBtnClick` 和 `handleBtnKeyDown` 事件处理器执行了按钮在鼠标单击或者按下 Space 或 Enter 键的操作。在这个例子中,操作是给名字列表添加一个新的名字。
+
+在文本框中添加名称以尝试这个例子。按钮会给列表添加一个新的名字。
+
+
+#### HTML
```html
+ARIA 按钮示例
+
+
+
Save添加名字
```
-### ARIA Toggle Button
+#### CSS
+
+```css
+[role="button"] {
+ padding: 2px;
+ background-color: navy;
+ color: white;
+ cursor: default;
+}
+[role="button"]:hover,
+[role="button"]:focus,
+[role="button"]:active {
+ background-color: white;
+ color: navy;
+}
+ul {
+ list-style: none;
+}
+```
+
+#### JavaScript
+
+```js
+function handleCommand(event) {
+ // 处理鼠标单击以及 Enter 或 Space 的激活
+
+ // 除 Enter 或 Space 之外的按钮不应该触发命令
+ if (
+ event instanceof KeyboardEvent &&
+ event.key !== "Enter" &&
+ event.key !== " "
+ ) {
+ return;
+ }
+
+ // 从输入框中获取新的名字
+ const newNameInput = document.getElementById("newName");
+ const name = newNameInput.value;
+ newNameInput.value = ""; // 清除文本框
+ newNameInput.focus(); // 给予文本框焦点,以允许添加额外的名称。
+
+ // 不要在列表中添加空白项。
+ if (name.length > 0) {
+ const listItem = document.createElement("li");
+ listItem.appendChild(document.createTextNode(name));
+
+ // 在列表中添加新的名字。
+ const list = document.getElementById("nameList");
+ list.appendChild(listItem);
+ }
+}
+```
-在这个片段中,使用 `button` 角色和 `aria-pressed` 属性,来将 `` 元素转换为一个切换按钮,当按钮被激活时, `aria-pressed` 的值在 true 和 false 之间切换。
+{{EmbedLiveSample("Basic_button_example")}}
+
+### 切换按钮示例
+
+在这个片段中,使用 `button` 角色和 `aria-pressed` 属性,来将 `` 元素转换为一个切换按钮,按钮被激活时, `aria-pressed` 的值在 `true`` 和 `false`` 之间切换。
#### HTML
+
```html
-
- Native button toggle
+
+ 静音音频
- Span button toggle
+ onKeyDown="handleBtnKeyDown(event)">
+ 静音音频
+
+
```
#### CSS
@@ -78,10 +215,11 @@ original_slug: Web/Accessibility/ARIA/ARIA_Techniques/Using_the_button_role
button,
[role="button"] {
padding: 3px;
- border: 1px solid #ccc;
+ border: 2px solid transparent;
}
-button[aria-pressed="true"],
+button:active,
+button:focus,
[role="button"][aria-pressed="true"] {
border: 2px solid #000;
}
@@ -94,35 +232,73 @@ function handleBtnClick(event) {
toggleButton(event.target);
}
-function handleBtnKeyPress(event) {
- // Check to see if space or enter were pressed
- if (event.key === " " || event.key === "Enter") {
- // Prevent the default action to stop scrolling when space is pressed
+function handleBtnKeyDown(event) {
+ // 检查 space 或 enter 是否已按下
+ // "Spacebar" 是为 IE11 支持
+ if (event.key === " " || event.key === "Enter" || event.key === "Spacebar") {
+ // 避免按下空格键时滚动屏幕的默认操作
event.preventDefault();
toggleButton(event.target);
}
}
function toggleButton(element) {
- // Check to see if the button is pressed
- var pressed = element.getAttribute("aria-pressed") === "true";
- // Change aria-pressed to the opposite state
+ const audio = document.getElementById("audio");
+
+ // 检查按钮是否已按下
+ const pressed = element.getAttribute("aria-pressed") === "true";
+
+ // 将 aria-pressed 设为相反的状态
element.setAttribute("aria-pressed", !pressed);
+
+ // 切换 audio 文件的 play 状态
+ if (pressed) {
+ audio.pause();
+ } else {
+ audio.play();
+ }
}
```
-### Result
+
+### 结果
{{EmbedLiveSample('ARIA_Toggle_Button')}}
-## Notes
+## 无障碍考虑
-### ARIA attributes used
+按钮本身是可交互的,因此可聚焦。如果给自身没有焦点的元素(如 ``、`` 或 `
`)添加了焦点,那么就应该使用 `tabindex` 属性以使用按钮可聚焦。
-- [`button`](https://www.w3.org/TR/wai-aria/roles#button)
-- [`aria-pressed`](https://www.w3.org/TR/wai-aria/states_and_properties#aria-pressed)
+> **警告:** 谨慎将链接标记为按钮。按钮是预期使用 Space 或 Enter 键触发的,而链接是预期使用 Enter 触发的。也就是说,如果使用了链接以表现得像是个按钮,仅添加 `role="button"` 是不够的。还有必要为 Space 添加一个键事件处理器,以与原生的按钮行为保持一致。
-### Additional resources
+使用了 `button` 角色时,屏幕阅读器会将其说成是一个按钮,通常是说“单击(click)”然后是其可访问的名称。可访问名称是元素的内容,或者 `aria-label` 的会是,或者由 `aria-labelledby` 属性引用的值,或者描述(如果已包括)。
-- [Strong native semantics in HTML5](https://www.w3.org/TR/html5/dom.html#aria-usage-note)
+## 最佳实践
+
+If a link performs the action of a button, giving the element `role="button"` helps assistive technology users understand the function of the element. However, a better solution is to adjust the visual design so it matches the function and ARIA role. Where possible, it is recommended to use native HTML buttons (``, ``, ``, `` and ``) rather than the `button` role, as native HTML buttons are supported by all user agents and assistive technology and provide keyboard and focus requirements by default, without need for additional customization.
+
+## 规范
+
+{{Specifications}}
+
+## 参见
+
+- {{HTMLElement('button')}} 元素
+- {{HTMLElement("input")}} 元素
+- [``](/zh-CN/docs/Web/HTML/Element/input/button)
+- [``](/zh-CN/docs/Web/HTML/Element/input/submit)
+- [``](/zh-CN/docs/Web/HTML/Element/input/reset)
+- [`aria-pressed`](https://www.w3.org/TR/wai-aria-1.1/#aria-pressed)
+- [`aria-expanded`](https://www.w3.org/TR/wai-aria-1.1/#aria-expanded)
+- [`aria-haspopup`](https://www.w3.org/TR/wai-aria-1.1/#aria-haspopup)
+- [Strong native semantics in HTML5](https://html.spec.whatwg.org/multipage/dom.html#aria-usage-note)
- [Notes on Using ARIA in HTML](https://www.w3.org/TR/aria-in-html/)
+- [Official WAI-ARIA example code](https://www.w3.org/TR/wai-aria-practices/examples/button/button.html)
+
+
+
+1. [**WAI-ARIA 角色**](/zh-CN/docs/Web/Accessibility/ARIA/Roles)
+
+ {{ListSubpagesForSidebar("/zh-CN/docs/Web/Accessibility/ARIA/Roles")}}
+
+
From aa88ec591049988d66b8321534a069a3fd4ffc92 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Sat, 22 Jul 2023 14:56:30 +0000
Subject: [PATCH 04/72] update list roles
---
.../aria/roles/list_role/index.md | 49 ++++++-----------
.../aria/roles/listbox_role/index.md | 14 ++---
.../aria/roles/listitem_role/index.md | 53 +++++++------------
3 files changed, 45 insertions(+), 71 deletions(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/list_role/index.md b/files/zh-cn/web/accessibility/aria/roles/list_role/index.md
index e2cefa618143d5..a4a3ab70315b82 100644
--- a/files/zh-cn/web/accessibility/aria/roles/list_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/list_role/index.md
@@ -1,5 +1,5 @@
---
-title: "ARIA: list role"
+title: "ARIA:list 角色"
slug: Web/Accessibility/ARIA/Roles/list_role
---
@@ -7,9 +7,9 @@ ARIA `list` 角色可用于标识项目列表。它通常与 `listitem` 角色
```html
- List item 1
- List item 2
- List item 3
+ 列表项 1
+ 列表项 2
+ 列表项 3
```
@@ -28,29 +28,17 @@ ARIA `list` 角色可用于标识项目列表。它通常与 `listitem` 角色
- [group](/zh-CN/docs/Web/Accessibility/ARIA/Roles/group_role)
- : 相关对象的集合,在嵌套在列表中时仅限于列表项,其重要性不足以在页面目录中拥有自己的位置。
-### 键盘交互
-
-无
-
-### 所需的 JavaScript 功能
-
-无
-
-## 示例
-
-[ARIA Lists](https://www.scottohara.me/blog/2018/05/26/aria-lists.html) — Scott O'Hara 的一些有用的例子和想法
-
## 最佳实践
仅在必要时使用 `role="list"` 和 `role="listitem"`。例如,无法控制 HTML 但能够在之后动态使用 JavaScript 提升无障碍的时候。
-与 HTML {{HTMLElement("ol")}} 和 {{HTMLElement("ul")}} 不同,ARIA `list` 角色不区分有序列表和无序列表。如果可能,您应该使用适当的语义 HTML 元素来标记列表({{HTMLElement("ol")}} 和 {{HTMLElement("ul")}})和列表项({{HTMLElement("li")}})。例如,我们上面的例子应该改写如下:
+与 HTML {{HTMLElement("ol")}} 和 {{HTMLElement("ul")}} 不同,ARIA `list` 角色不区分有序列表和无序列表。如果可能,您应该使用适当的语义 HTML 元素来标记列表({{HTMLElement("ol")}} 和 {{HTMLElement("ul")}})和列表项({{HTMLElement("li")}})。例如,我们上面的例子应该改写如下:
```html
- - List item 1
- - List item 2
- - List item 3
+ - 列表项 1
+ - 列表项 2
+ - 列表项 3
```
@@ -58,9 +46,9 @@ ARIA `list` 角色可用于标识项目列表。它通常与 `listitem` 角色
```html
- - List item 1
- - List item 2
- - List item 3
+ - 列表项 1
+ - 列表项 2
+ - 列表项 3
```
@@ -74,19 +62,16 @@ ARIA `list` 角色可用于标识项目列表。它通常与 `listitem` 角色
{{Specifications}}
-## 屏幕阅读器支持
-
-TBD
-
## 参见
+- {{HTMLElement("ul")}} 元素
+- {{HTMLElement("ol")}} 元素
+- The {{HTMLElement("li")}} 元素
+- [ARIA:listitem 角色](/zh-CN/docs/Web/Accessibility/ARIA/Roles/listitem_role)
+- [ARIA:group 角色](/zh-CN/docs/Web/Accessibility/ARIA/Roles/group_role)
+- [ARIA 列表示例](https://www.scottohara.me/blog/2018/05/26/aria-lists.html) — by Scott O'Hara
- [Accessibility Object Model](https://wicg.github.io/aom/spec/)
- [ARIA in HTML](https://w3c.github.io/html-aria/)
-- {{HTMLElement("ul")}}
-- {{HTMLElement("ol")}}
-- {{HTMLElement("li")}}
-- [ARIA: listitem role](/zh-CN/docs/Web/Accessibility/ARIA/Roles/Listitem_role)
-- [ARIA: group role](/zh-CN/docs/Web/Accessibility/ARIA/Roles/group_role)
diff --git a/files/zh-cn/web/accessibility/aria/roles/listbox_role/index.md b/files/zh-cn/web/accessibility/aria/roles/listbox_role/index.md
index d10e144617a685..b610b9ed0e0222 100644
--- a/files/zh-cn/web/accessibility/aria/roles/listbox_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/listbox_role/index.md
@@ -1,5 +1,5 @@
---
-title: "ARIA: listbox role"
+title: "ARIA:listbox 角色"
slug: Web/Accessibility/ARIA/Roles/listbox_role
---
@@ -201,10 +201,6 @@ slug: Web/Accessibility/ARIA/Roles/listbox_role
{{Specifications}}
-## 屏幕阅读器支持
-
-TBD
-
## 参见
- {{HTMLElement("select")}} 元素
@@ -217,4 +213,10 @@ TBD
- [ARIA Best Practices – Listbox](https://www.w3.org/TR/wai-aria-practices/#Listbox)
- [ARIA Role Model – Listbox](https://www.w3.org/TR/wai-aria-1.1/#listbox)
-- WAI-ARIA roles{{ListSubpagesForSidebar("/zh-CN/docs/Web/Accessibility/ARIA/Roles")}}
+
+
+1. [**WAI-ARIA roles**](/en-US/docs/Web/Accessibility/ARIA/Roles)
+
+ {{ListSubpagesForSidebar("/en-US/docs/Web/Accessibility/ARIA/Roles")}}
+
+
\ No newline at end of file
diff --git a/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md b/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md
index 7dea57c3183c24..ebec3983e874ed 100644
--- a/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md
@@ -1,15 +1,15 @@
---
-title: "ARIA: listitem role"
+title: "ARIA: listitem 角色"
slug: Web/Accessibility/ARIA/Roles/listitem_role
---
-ARIA `listitem` 角色可用于标识项目列表中的项目。它通常与 `list` 角色结合使用,用于标识列表容器。
+ARIA `listitem` 角色可用于标识项目列表中的项目。它通常与 [`list`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/list_role) 角色结合使用,用于标识列表容器。
```html
- List item 1
- List item 2
- List item 3
+ 列表项 1
+ 列表项 2
+ 列表项 3
```
@@ -28,29 +28,17 @@ ARIA `listitem` 角色可用于标识项目列表中的项目。它通常与 `li
- [group](/zh-CN/docs/Web/Accessibility/ARIA/Roles/group_role)
- : 相关对象的集合,在嵌套在列表中时仅限于列表项,其重要性不足以在页面目录中拥有自己的位置。
-### 键盘交互
-
-无
-
-### 所需的 JavaScript 功能
-
-无
-
-## 示例
-
-[ARIA Lists](https://www.scottohara.me/blog/2018/05/26/aria-lists.html) — Scott O'Hara 的一些有用的例子和想法
-
## 最佳实践
仅在必要时使用 `role="list"` 和 `role="listitem"`。例如,无法控制 HTML 但能够在之后动态使用 JavaScript 提升无障碍的时候。
-与 HTML {{HTMLElement("ol")}} 和 {{HTMLElement("ul")}} 不同,ARIA `list` 角色不区分有序列表和无序列表。如果可能,您应该使用适当的语义 HTML 元素来标记列表({{HTMLElement("ol")}} 和 {{HTMLElement("ul")}})和列表项({{HTMLElement("li")}})。例如,我们上面的例子应该改写如下:
+与 HTML {{HTMLElement("ol")}} 和 {{HTMLElement("ul")}} 不同,ARIA `list` 角色不区分有序列表和无序列表。如果可能,您应该使用适当的语义 HTML 元素来标记列表({{HTMLElement("ol")}} 和 {{HTMLElement("ul")}})和列表项({{HTMLElement("li")}})。例如,我们上面的例子应该改写如下:
```html
- - List item 1
- - List item 2
- - List item 3
+ - 列表项 1
+ - 列表项 2
+ - 列表项 3
```
@@ -58,33 +46,32 @@ ARIA `listitem` 角色可用于标识项目列表中的项目。它通常与 `li
```html
- - List item 1
- - List item 2
- - List item 3
+ - 列表项 1
+ - 列表项 2
+ - 列表项 3
```
> **备注:** ARIA `list` / `listitem` 角色不区分有序列表和无序列表。
+> **备注:** 给列表添加 CSS 样式 `list-style: none;` 移除列表语义。添加 `role="listitem"` 返回列表语义。
+
> **备注:** 如果要标记将用作选项卡式界面的项目列表,则应改为使用 `tab`、`tabpanel` 和 `tablist` 角色。
## 规范
{{Specifications}}
-## 屏幕阅读器支持
-
-TBD
-
## 参见
+- [HTML `` 元素](/zh-CN/docs/Web/HTML/Element/li)
+- [HTML `` 元素](/zh-CN/docs/Web/HTML/Element/ul)
+- [HTML `` 元素](/zh-CN/docs/Web/HTML/Element/ol)
+- [ARIA:`list` 角色](/zh-CN/docs/Web/Accessibility/ARIA/Roles/list_role)
+- [ARIA:`group` 角色](/zh-CN/docs/Web/Accessibility/ARIA/Roles/group_role)
- [Accessibility Object Model](https://wicg.github.io/aom/spec/)
- [ARIA in HTML](https://w3c.github.io/html-aria/)
-- {{HTMLElement("ul")}}
-- {{HTMLElement("ol")}}
-- {{HTMLElement("li")}}
-- [ARIA: list role](/zh-CN/docs/Web/Accessibility/ARIA/Roles/List_role)
-- [ARIA: group role](/zh-CN/docs/Web/Accessibility/ARIA/Roles/group_role)
+- [ARIA Lists examples](https://www.scottohara.me/blog/2018/05/26/aria-lists.html) — by Scott O'Hara
From f21e575ca4ee2b309fcf8e2446f9ef55d71c5e03 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Sat, 22 Jul 2023 14:59:51 +0000
Subject: [PATCH 05/72] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=20lint=20markdown=20fi?=
=?UTF-8?q?les?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
files/zh-cn/web/accessibility/aria/index.md | 2 +-
.../web/accessibility/aria/roles/button_role/index.md | 8 +-------
2 files changed, 2 insertions(+), 8 deletions(-)
diff --git a/files/zh-cn/web/accessibility/aria/index.md b/files/zh-cn/web/accessibility/aria/index.md
index 6da7700ab9ea60..bc3bb8f22101ad 100644
--- a/files/zh-cn/web/accessibility/aria/index.md
+++ b/files/zh-cn/web/accessibility/aria/index.md
@@ -75,7 +75,7 @@ function updateProgress(percentComplete) {
```
-> **Note:** {{HTMLElement('progress')}} 元素不允许 `min` 属性,最小值永远为 0。
+> **Note:** {{HTMLElement('progress')}} 元素不允许 `min` 属性,最小值永远为 0。
> HTML 陆标元素({{HTMLElement("main")}}、{{HTMLElement("header")}}、{{HTMLElement("nav")}} 等)具有内置的 ARIA 角色,因此有无需复制它们。
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index 3027d443606175..a19342215bddec 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -29,7 +29,6 @@ button 角色会向辅助技术(如屏幕阅读器)识别一个元素为按
菜单按钮是指控制一个菜单且 [`aria-haspopup`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-haspopup) 属性设置为 `menu` 或 `true` 的按钮。
-
### 所有子元素都是 presentation
有些类型的用户界面元件,当呈现为平台无障碍 API 时,仅可包含文本。无障碍 API 没有呈现 `button` 中包含的语义元素的方式。要处理这个限制,浏览器会自动为任何 `button` 的后代元素应用角色 [`presentation`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/presentation_role),因为按钮这种角色不支持带有语义的子元素。
@@ -59,7 +58,6 @@ button 角色会向辅助技术(如屏幕阅读器)识别一个元素为按
- [`aria-expanded`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-expanded)
- : 如果按钮控制了其他元素的分组,`aria-expanded` 状态指示了被控制的分组当前是被展开还是折叠。如果按钮有设置了 `aria-expanded="false"`,那么分组当前没有开,如果被展开了,则按钮会有 `aria-expanded="undefined"`,如果属性被忽略,则是不可展开。
-
### 基本的按钮
Buttons should always have an accessible name. For most buttons, this name will be the same as the text inside the button, between the opening and closing tags. In some cases, for example buttons represented by icons, the accessible name may be provided from the [`aria-label`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-label) or [`aria-labelledby`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-labelledby) attributes.
@@ -84,7 +82,6 @@ As an example, the mute button on an audio player labeled "mute" could indicate
Following button activation, focus is set depending on the type of action the button performs. For example, if clicking the button opens a dialog, the focus should move to the dialog. If the button closes a dialog, focus should return to the button that opened the dialog unless the function performed in the dialog context logically leads to a different element. If the button alters the current context, such as muting and unmuting an audio file, then focus typically remains on the button.
-
### Required JavaScript Features
#### Required event handlers
@@ -106,7 +103,6 @@ Buttons can be operated by mouse, touch, and keyboard users. For native HTML `` 元素转换为一个切换按钮,按钮被激活时, `aria-pressed` 的值在 `true`` 和 `false`` 之间切换。
+在这个片段中,使用 `button` 角色和 `aria-pressed` 属性,来将 `` 元素转换为一个切换按钮,按钮被激活时,`aria-pressed` 的值在 `true` 和 `false` 之间切换。
#### HTML
-
```html
Date: Sat, 22 Jul 2023 15:07:54 +0000
Subject: [PATCH 06/72] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=20lint=20markdown=20fi?=
=?UTF-8?q?les?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
files/zh-cn/web/accessibility/aria/roles/listbox_role/index.md | 2 +-
files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md | 2 +-
2 files changed, 2 insertions(+), 2 deletions(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/listbox_role/index.md b/files/zh-cn/web/accessibility/aria/roles/listbox_role/index.md
index b610b9ed0e0222..857f5171dc9032 100644
--- a/files/zh-cn/web/accessibility/aria/roles/listbox_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/listbox_role/index.md
@@ -219,4 +219,4 @@ slug: Web/Accessibility/ARIA/Roles/listbox_role
{{ListSubpagesForSidebar("/en-US/docs/Web/Accessibility/ARIA/Roles")}}
-
\ No newline at end of file
+
diff --git a/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md b/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md
index ebec3983e874ed..1be3136d2a2653 100644
--- a/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md
@@ -3,7 +3,7 @@ title: "ARIA: listitem 角色"
slug: Web/Accessibility/ARIA/Roles/listitem_role
---
-ARIA `listitem` 角色可用于标识项目列表中的项目。它通常与 [`list`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/list_role) 角色结合使用,用于标识列表容器。
+ARIA `listitem` 角色可用于标识项目列表中的项目。它通常与 [`list`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/list_role) 角色结合使用,用于标识列表容器。
```html
From b2ed4c0efb66243dd88bef39f08f400876a89d70 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Sun, 23 Jul 2023 04:49:44 +0000
Subject: [PATCH 07/72] prettier
---
.../zh-cn/web/accessibility/aria/roles/button_role/index.md | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index a19342215bddec..cd882ea88afe76 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -75,10 +75,10 @@ As an example, the mute button on an audio player labeled "mute" could indicate
### 键盘交互
-| 按键 | 功能 |
-| ---------------- | --------------------- |
+| 按键 | 功能 |
+| ---------------- | ---------- |
| Enter | 激活按钮。 |
-| Space | 激活按钮。 |
+| Space | 激活按钮。 |
Following button activation, focus is set depending on the type of action the button performs. For example, if clicking the button opens a dialog, the focus should move to the dialog. If the button closes a dialog, focus should return to the button that opened the dialog unless the function performed in the dialog context logically leads to a different element. If the button alters the current context, such as muting and unmuting an audio file, then focus typically remains on the button.
From dfa03e657f0d1847217a318b0ecd5f3f130300fa Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Sun, 23 Jul 2023 11:54:28 +0000
Subject: [PATCH 08/72] Fix
---
.../web/accessibility/aria/roles/listbox_role/index.md | 4 ++--
.../web/accessibility/aria/roles/listitem_role/index.md | 6 +++---
2 files changed, 5 insertions(+), 5 deletions(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/listbox_role/index.md b/files/zh-cn/web/accessibility/aria/roles/listbox_role/index.md
index 857f5171dc9032..0a3eba8108366d 100644
--- a/files/zh-cn/web/accessibility/aria/roles/listbox_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/listbox_role/index.md
@@ -215,8 +215,8 @@ slug: Web/Accessibility/ARIA/Roles/listbox_role
-1. [**WAI-ARIA roles**](/en-US/docs/Web/Accessibility/ARIA/Roles)
+1. [**WAI-ARIA 角色**](/en-US/docs/Web/Accessibility/ARIA/Roles)
- {{ListSubpagesForSidebar("/en-US/docs/Web/Accessibility/ARIA/Roles")}}
+ {{ListSubpagesForSidebar("/zh-CN/docs/Web/Accessibility/ARIA/Roles")}}
diff --git a/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md b/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md
index 1be3136d2a2653..89ace03eedb243 100644
--- a/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md
@@ -69,9 +69,9 @@ ARIA `listitem` 角色可用于标识项目列表中的项目。它通常与 [`l
- [HTML `` 元素](/zh-CN/docs/Web/HTML/Element/ol)
- [ARIA:`list` 角色](/zh-CN/docs/Web/Accessibility/ARIA/Roles/list_role)
- [ARIA:`group` 角色](/zh-CN/docs/Web/Accessibility/ARIA/Roles/group_role)
-- [Accessibility Object Model](https://wicg.github.io/aom/spec/)
-- [ARIA in HTML](https://w3c.github.io/html-aria/)
-- [ARIA Lists examples](https://www.scottohara.me/blog/2018/05/26/aria-lists.html) — by Scott O'Hara
+- [无障碍对象模型](https://wicg.github.io/aom/spec/)
+- [HTML 中的 ARIA](https://w3c.github.io/html-aria/)
+- [ARIA 列表示例](https://www.scottohara.me/blog/2018/05/26/aria-lists.html) — by Scott O'Hara
From 2faf0e288cbc1ac4321842a1fdb53362c8192d19 Mon Sep 17 00:00:00 2001
From: Allo
Date: Sun, 30 Jul 2023 10:19:29 +0800
Subject: [PATCH 09/72] add the translation of "ARIA"
---
files/zh-cn/web/accessibility/aria/index.md | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/files/zh-cn/web/accessibility/aria/index.md b/files/zh-cn/web/accessibility/aria/index.md
index bc3bb8f22101ad..89c8ff9020c2b0 100644
--- a/files/zh-cn/web/accessibility/aria/index.md
+++ b/files/zh-cn/web/accessibility/aria/index.md
@@ -25,15 +25,15 @@ slug: Web/Accessibility/ARIA
-**ARIA** (Accessible Rich Internet Applications) 是一组[角色](/zh-CN/docs/Web/Accessibility/ARIA/Roles)和[特性](/zh-CN/docs/Web/Accessibility/ARIA/Attributes),用于定义使残障人士更容易访问 Web 内容和 Web 应用程序(尤其是使用 JavaScript 开发的应用程序)的方法。
+无障碍富互联网应用(Accessible Rich Internet Applications,**ARIA**)是一组[角色](/zh-CN/docs/Web/Accessibility/ARIA/Roles)和[特性](/zh-CN/docs/Web/Accessibility/ARIA/Attributes),用于定义使残障人士更易于访问 web 内容和 web 应用程序(尤其是使用 JavaScript 开发的应用程序)的方法。
-它补充了 HTML,以便在没有其他机制时可以将应用程序中常用的交互和小部件传递给辅助技术。例如,ARIA 支持 HTML4 中的无障碍 JavaScript 小部件、表单提示和错误消息、实时内容更新等。
+它补充了 HTML,以便在没有其他机制时可以将应用程序中常用的交互和小部件传递给辅助技术。例如,ARIA 支持无障碍 JavaScript 小部件、表单提示和错误消息、实时内容更新等。
> **警告:** 许多这些小部件后来被合并到 HTML5 中,如果存在这样的元素,**开发人员应该更喜欢使用正确语义的 HTML 元素而不是使用 ARIA**。例如,原生元素具有内置的[键盘无障碍](/zh-CN/docs/Web/Accessibility/Keyboard-navigable_JavaScript_widgets)、角色和状态。但是,如果您选择使用 ARIA,则您有责任在脚本中模仿(等效)浏览器行为。
使用 [ARIA 的第一规则](https://www.w3.org/TR/using-aria/#rule1)是“如果你能够使用原生的 HTML 元素或属性,并且有你需要但已经建立在里面的语义和行为,而不是重新调整元素的用途并添加 ARIA 角色、状态或者属性来使它更加无障碍,那么你就应该如此。”
-> **注意:** 有个说法叫做“ARIA 宁缺毋滥”。在 [WebAim's survey of over one million home pages](https://webaim.org/projects/million/#aria) 中,他们发生,有 ARIA 存在的主页比那些没有 ARIA 的,多检测出了平均 41% 的错误。尽管 ARIA 是为了使网页更加无障碍而设计的,但是如果使用不当,可能适得其反。
+> **备注:** 有个说法叫做“ARIA 宁缺毋滥”。在 [WebAim's survey of over one million home pages](https://webaim.org/projects/million/#aria) 中,他们发生,有 ARIA 存在的主页比那些没有 ARIA 的,多检测出了平均 41% 的错误。尽管 ARIA 是为了使网页更加无障碍而设计的,但是如果使用不当,可能适得其反。
这是进度条小部件的标记:
From a0979517bceceded4fd7a78138ab37713e4c106c Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Mon, 31 Jul 2023 01:26:11 +0000
Subject: [PATCH 10/72] =?UTF-8?q?=E6=9B=B4=E6=AD=A3=E7=BF=BB=E8=AF=91?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
files/zh-cn/web/accessibility/aria/index.md | 12 ++++++------
files/zh-cn/web/accessibility/aria/roles/index.md | 4 ++--
.../accessibility/aria/roles/listbox_role/index.md | 2 +-
3 files changed, 9 insertions(+), 9 deletions(-)
diff --git a/files/zh-cn/web/accessibility/aria/index.md b/files/zh-cn/web/accessibility/aria/index.md
index 89c8ff9020c2b0..7349fdfd0e5ad7 100644
--- a/files/zh-cn/web/accessibility/aria/index.md
+++ b/files/zh-cn/web/accessibility/aria/index.md
@@ -7,7 +7,7 @@ slug: Web/Accessibility/ARIA
- ARIA 注解
- ARIA 指南
- - ARIA 流动区域
+ - ARIA 实时区域
- ARIA 屏幕阅读器实现指南
- 使用 ARIA:角色、状态和属性
- 多部分标签
@@ -25,15 +25,15 @@ slug: Web/Accessibility/ARIA
-无障碍富互联网应用(Accessible Rich Internet Applications,**ARIA**)是一组[角色](/zh-CN/docs/Web/Accessibility/ARIA/Roles)和[特性](/zh-CN/docs/Web/Accessibility/ARIA/Attributes),用于定义使残障人士更易于访问 web 内容和 web 应用程序(尤其是使用 JavaScript 开发的应用程序)的方法。
+无障碍富互联网应用(Accessible Rich Internet Applications,**ARIA**)是一组[角色](/zh-CN/docs/Web/Accessibility/ARIA/Roles)和[属性](/zh-CN/docs/Web/Accessibility/ARIA/Attributes),用于定义使残障人士更易于访问 web 内容和 web 应用程序(尤其是使用 JavaScript 开发的应用程序)的方法。
它补充了 HTML,以便在没有其他机制时可以将应用程序中常用的交互和小部件传递给辅助技术。例如,ARIA 支持无障碍 JavaScript 小部件、表单提示和错误消息、实时内容更新等。
-> **警告:** 许多这些小部件后来被合并到 HTML5 中,如果存在这样的元素,**开发人员应该更喜欢使用正确语义的 HTML 元素而不是使用 ARIA**。例如,原生元素具有内置的[键盘无障碍](/zh-CN/docs/Web/Accessibility/Keyboard-navigable_JavaScript_widgets)、角色和状态。但是,如果您选择使用 ARIA,则您有责任在脚本中模仿(等效)浏览器行为。
+> **警告:** 许多这些小部件在现代浏览器中都已经完全支持。如果有正确语义的 HTML 元素存在的话,**开发人员应该更喜欢使用这样的元素而不是使用 ARIA**。例如,原生元素具有内置的[键盘无障碍](/zh-CN/docs/Web/Accessibility/Keyboard-navigable_JavaScript_widgets)、角色和状态。但是,如果您选择使用 ARIA,则你有责任在脚本中模仿(等效)浏览器行为。
使用 [ARIA 的第一规则](https://www.w3.org/TR/using-aria/#rule1)是“如果你能够使用原生的 HTML 元素或属性,并且有你需要但已经建立在里面的语义和行为,而不是重新调整元素的用途并添加 ARIA 角色、状态或者属性来使它更加无障碍,那么你就应该如此。”
-> **备注:** 有个说法叫做“ARIA 宁缺毋滥”。在 [WebAim's survey of over one million home pages](https://webaim.org/projects/million/#aria) 中,他们发生,有 ARIA 存在的主页比那些没有 ARIA 的,多检测出了平均 41% 的错误。尽管 ARIA 是为了使网页更加无障碍而设计的,但是如果使用不当,可能适得其反。
+> **备注:** 有个说法叫做“ARIA 宁缺毋滥”。在 [WebAim's survey of over one million home pages](https://webaim.org/projects/million/#aria) 中,他们发现,有 ARIA 存在的主页比那些没有 ARIA 的,多检测出了平均 41% 的错误。尽管 ARIA 是为了使网页更加无障碍而设计的,但是如果使用不当,可能适得其反。
这是进度条小部件的标记:
@@ -75,9 +75,9 @@ function updateProgress(percentComplete) {
```
-> **Note:** {{HTMLElement('progress')}} 元素不允许 `min` 属性,最小值永远为 0。
+> **注释:** {{HTMLElement('progress')}} 元素不允许 `min` 属性,最小值永远为 0。
-> HTML 陆标元素({{HTMLElement("main")}}、{{HTMLElement("header")}}、{{HTMLElement("nav")}} 等)具有内置的 ARIA 角色,因此有无需复制它们。
+> HTML 地标元素({{HTMLElement("main")}}、{{HTMLElement("header")}}、{{HTMLElement("nav")}} 等)具有内置的 ARIA 角色,因此有无需复制它们。
## 支持
diff --git a/files/zh-cn/web/accessibility/aria/roles/index.md b/files/zh-cn/web/accessibility/aria/roles/index.md
index ef4dfe7da605ae..489445e4283ae0 100644
--- a/files/zh-cn/web/accessibility/aria/roles/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/index.md
@@ -97,9 +97,9 @@ ARIA 角色共分为 6 类:
注意还有个 widget 角色(`role="widget"`),这是个抽象的角色,不在小部件角色类别中。
-### 3. 陆标角色
+### 3. 地标角色
-陆标角色提供了一种识别网页的组织和结构的方法。对页面的各个部分进行分类并加标,可以以编程方式呈现出通过布局直观传达的结构信息。屏幕阅读器使用陆标角色为页面的重要部分提供键盘导航。谨慎使用这些。太多的陆标角色会在屏幕阅读器中产生“噪音”,导致难以理解页面的整体布局。
+地标角色提供了一种识别网页的组织和结构的方法。对页面的各个部分进行分类并加标,可以以编程方式呈现出通过布局直观传达的结构信息。屏幕阅读器使用地标角色为页面的重要部分提供键盘导航。谨慎使用这些。太多的地标角色会在屏幕阅读器中产生“噪音”,导致难以理解页面的整体布局。
- [banner](/zh-CN/docs/Web/Accessibility/ARIA/Roles/banner_role) (文档 {{HTMLElement('header')}})
- [complementary](/zh-CN/docs/Web/Accessibility/ARIA/Roles/complementary_role)({{HTMLElement('aside')}})
diff --git a/files/zh-cn/web/accessibility/aria/roles/listbox_role/index.md b/files/zh-cn/web/accessibility/aria/roles/listbox_role/index.md
index 0a3eba8108366d..f15a676ecbeccf 100644
--- a/files/zh-cn/web/accessibility/aria/roles/listbox_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/listbox_role/index.md
@@ -215,7 +215,7 @@ slug: Web/Accessibility/ARIA/Roles/listbox_role
-1. [**WAI-ARIA 角色**](/en-US/docs/Web/Accessibility/ARIA/Roles)
+1. [**WAI-ARIA 角色**](/zh-CN/docs/Web/Accessibility/ARIA/Roles)
{{ListSubpagesForSidebar("/zh-CN/docs/Web/Accessibility/ARIA/Roles")}}
From 4559c219119e92642db274d7d01f42de6d813d4d Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Mon, 31 Jul 2023 15:50:15 +0800
Subject: [PATCH 11/72] Update
files/zh-cn/web/accessibility/aria/roles/button_role/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index cd882ea88afe76..66b4c776438ed7 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -9,7 +9,7 @@ slug: Web/Accessibility/ARIA/Roles/button_role
button 角色会向辅助技术(如屏幕阅读器)识别一个元素为按钮。按钮是用于执行操作的小部件,例如提交表单、打开对话框、退出活动或执行一个命令,例如插入新的记录或者显示信息。添加 `role="button"` 会告诉辅助技术,这是一个按钮,但是不提供按钮的功能。你应该使用 {{HTMLElement("button")}} 或者 {{HTMLElement("input")}} 以及 `type="button"`。
-`button` 角色可以和 [`aria-pressed`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-pressed) 发生一起使用,以[创建切换按钮](#toggle_buttons)。
+`button` 角色可以和 [`aria-pressed`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-pressed) 特性一起使用,以[创建切换按钮](#切换按钮)。
```html
保存
From ec076a6743cc775021476e9d2fbf94e9d0b72d56 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Mon, 31 Jul 2023 15:50:25 +0800
Subject: [PATCH 12/72] Update
files/zh-cn/web/accessibility/aria/roles/button_role/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index 66b4c776438ed7..70cc1c5067a641 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -15,7 +15,7 @@ button 角色会向辅助技术(如屏幕阅读器)识别一个元素为按
保存
```
-上面这个例子创建了一个可聚焦的按钮,但是需要 JavaScript 和 CSS 来包含按钮的外观和行为。这些功能默认是由 {{HTMLElement("button")}} 或者 {{HTMLElement("input")}}(带有 `type="button"`)元素提供的。`
+上面这个例子创建了一个可聚焦的按钮,但是需要 JavaScript 和 CSS 来包含按钮的外观和行为。这些功能默认是由 {{HTMLElement("button")}} 或者 {{HTMLElement("input")}}(带有 `type="button"`)元素提供的。
```html
保存
From bd3e2f7e89a8d1f20be01e697ec371c044d58a7a Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Mon, 31 Jul 2023 15:50:41 +0800
Subject: [PATCH 13/72] Update
files/zh-cn/web/accessibility/aria/roles/button_role/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index 70cc1c5067a641..b02c8e1faa267b 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -21,7 +21,7 @@ button 角色会向辅助技术(如屏幕阅读器)识别一个元素为按
保存
```
-> **注意:** 如果使用 `role="button"` 而不是语义的 `` 或 `` 元素,你需要让这个元素可聚焦并定义事件处理器 {{domxref("Element/click_event", "click")}} 和 {{domxref("Element/keydown_event", "keydown")}}。这包括了按下 Enter 和 Space 键盘按键以处理各种形式的用户输入。参见 [官方的 WAI-ARIA 示例代码](https://www.w3.org/TR/wai-aria-practices/examples/button/button.html)。
+> **备注:** 如果使用 `role="button"` 而不是语义化的 `` 或 `` 元素,你需要让这个元素可聚焦并定义事件处理器 {{domxref("Element/click_event", "click")}} 和 {{domxref("Element/keydown_event", "keydown")}}。这包括了按下 Enter 和 Space 键盘按键以处理各种形式的用户输入。参见[官方的 WAI-ARIA 示例代码](https://www.w3.org/TR/wai-aria-practices/examples/button/button.html)。
除了常见的按钮部件之外,使用非按钮元素创建切换按钮和菜单按钮时,应该使用 `role="button"`。
From e6268ef69d6df08c4f56095710892703ffd69570 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 1 Aug 2023 14:38:16 +0000
Subject: [PATCH 14/72] =?UTF-8?q?=E8=A1=A5=E5=85=85=E7=BF=BB=E8=AF=91=20ar?=
=?UTF-8?q?ia/roles/button=5Frole/index.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../aria/roles/button_role/index.md | 20 +++++++++----------
1 file changed, 10 insertions(+), 10 deletions(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index b02c8e1faa267b..32cdbea59c3682 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -60,7 +60,7 @@ button 角色会向辅助技术(如屏幕阅读器)识别一个元素为按
### 基本的按钮
-Buttons should always have an accessible name. For most buttons, this name will be the same as the text inside the button, between the opening and closing tags. In some cases, for example buttons represented by icons, the accessible name may be provided from the [`aria-label`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-label) or [`aria-labelledby`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-labelledby) attributes.
+按钮始终应该有无障碍的名称。对于大多数的按钮,名称通常是和按钮内的文本、开启和闭合标签之间的内容一致的。一些情况下,比如以图标形式呈现的按钮,其无障碍名称可能是由 [`aria-label`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-label) 或者 [`aria-labelledby`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-labelledby) 属性提供的。
## 切换按钮
@@ -71,7 +71,7 @@ Buttons should always have an accessible name. For most buttons, this name will
- 如果 `aria-pressed="true"`。说明这个按钮当前已被按下。
- 如果 `aria-pressed="mixed"`,说明这个按钮被认为是部分按下的。
-As an example, the mute button on an audio player labeled "mute" could indicate that sound is muted by setting the `aria-pressed` state true. The label of a toggle button should not change when its state changes. In our example the label remains "Mute" with a screen reader reading "Mute toggle button pressed" or "Mute toggle button not pressed" depending on the value of `aria-pressed`. If the design were to call for the button label to change from "Mute" to "Unmute," a toggle button would not be appropriate, so the `aria-pressed` attribute would be omitted.
+比如,音频播放器上有“静音”标签的静音按钮应该表示当 `aria-pressed` 状态为 true 时声音是静音的。切换按钮的标签不应该随状态改变而改变。在这个例子中,当屏幕阅读器说“静音切换按钮已按下”或者“静音切换按钮未按下”(取决于 `aria-pressed` 时),按钮的标签都始终为“静音”。如果设计时是要让按钮标签由“静音”更改为“取消静音”,那么这时候切换按钮并不合适,`aria-pressed` 属性应该省略。
### 键盘交互
@@ -80,18 +80,18 @@ As an example, the mute button on an audio player labeled "mute" could indicate
| Enter | 激活按钮。 |
| Space | 激活按钮。 |
-Following button activation, focus is set depending on the type of action the button performs. For example, if clicking the button opens a dialog, the focus should move to the dialog. If the button closes a dialog, focus should return to the button that opened the dialog unless the function performed in the dialog context logically leads to a different element. If the button alters the current context, such as muting and unmuting an audio file, then focus typically remains on the button.
+按钮激活后,会设置焦点,取决于按钮执行的操作的类型。比如,如果点击打开对话框的按钮,那么焦点应该移动到对话框。如果按钮是关闭对话框的,那么焦点应该回到打开对话框的按钮,除非对话框上下文中执行的功能在逻辑上是导向到不同的元素的。如果按钮更改了当前的上下文,例如将音频文件静音或者取消静音,那么焦点通常应该留在按钮上。
-### Required JavaScript Features
+### 必需的 JavaScript 功能
-#### Required event handlers
+#### 必需的事件处理器
-Buttons can be operated by mouse, touch, and keyboard users. For native HTML `` elements, the button's `onclick` event fires for mouse clicks and when the user presses Space or Enter while the button has focus. But if another tag is used to create a button, the `onclick` event only fires when clicked by the mouse cursor, even if `role="button"` is used. Because of this, separate key event handlers must be added to the element so that the button is be triggered when the Space or Enter key is pressed.
+按钮可能是由鼠标、触屏或者键盘用户操作的。对于原生的 `` 元素,按钮的 `onclick` 事件会在用户点击时,以及在按钮有焦点时用户按下 Space 或 Enter 时触发。但如果有其他的标签用于创建按钮,那么 `onclick` 事件只会有用户使用鼠标指针点击时才会触发,即使使用了 `role="button"`。因此,需要给元素添加单独的事件处理器,以在按下 Space 或 Enter 键时触发按钮。
- `onclick`
- - : Handles the event raised when the button is activated using a mouse click or touch event.
+ - : 使用鼠标点击或者触摸事件激活按钮时产生的事件。
- `onKeyDown`
- - : Handles the event raised when the button is activated using the Enter or Space key on the keyboard. (Note not the [deprecated onKeyPress](/zh-CN/docs/Web/API/Element/keypress_event))
+ - : 使用键盘上的 Enter 或 Space 键激活按钮时触发的事件。(注意不是[已弃用的 onKeyPress](/zh-CN/docs/Web/API/Element/keypress_event)。)
## 示例
@@ -261,7 +261,7 @@ function toggleButton(element) {
## 无障碍考虑
-按钮本身是可交互的,因此可聚焦。如果给自身没有焦点的元素(如 ``、`` 或 `
`)添加了焦点,那么就应该使用 `tabindex` 属性以使用按钮可聚焦。
+按钮本身是可交互的,因此可聚焦。如果给自身没有焦点的元素(如 ``、`` 或 `
`)添加了焦点,那么就应该使用 `tabindex` 属性以使得按钮可聚焦。
> **警告:** 谨慎将链接标记为按钮。按钮是预期使用 Space 或 Enter 键触发的,而链接是预期使用 Enter 触发的。也就是说,如果使用了链接以表现得像是个按钮,仅添加 `role="button"` 是不够的。还有必要为 Space 添加一个键事件处理器,以与原生的按钮行为保持一致。
@@ -269,7 +269,7 @@ function toggleButton(element) {
## 最佳实践
-If a link performs the action of a button, giving the element `role="button"` helps assistive technology users understand the function of the element. However, a better solution is to adjust the visual design so it matches the function and ARIA role. Where possible, it is recommended to use native HTML buttons (``, ``, ``, `` and ``) rather than the `button` role, as native HTML buttons are supported by all user agents and assistive technology and provide keyboard and focus requirements by default, without need for additional customization.
+如果链接执行的是按钮的操作,那么给元素 `role="button"` 可以帮助辅助技术用户理解这个元素的功能。然后,更好的设计是调整视觉设计从而匹配其功能和 ARIA 角色。在有可能时,建议使用原生的 HTML 按钮(``、``、``、`` 和 ``)而不是 `button` 角色,因为能够被所有的用户代理和辅助技术都支持,且默认会提供键盘和焦点需求而不需要额外的自定义。
## 规范
From b85f4effdc8eaf0656800915de724db635510c71 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Thu, 3 Aug 2023 11:02:23 +0800
Subject: [PATCH 15/72] Update
files/zh-cn/web/accessibility/aria/roles/button_role/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index 32cdbea59c3682..13af2250551ff8 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -172,7 +172,7 @@ function handleCommand(event) {
}
```
-{{EmbedLiveSample("Basic_button_example")}}
+{{EmbedLiveSample("基本按钮示例")}}
### 切换按钮示例
From 3da917062efa0909f5b5d342b318d657b53eba7d Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Thu, 3 Aug 2023 11:02:54 +0800
Subject: [PATCH 16/72] Update
files/zh-cn/web/accessibility/aria/roles/button_role/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index 13af2250551ff8..bb6ffefb7f8584 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -257,7 +257,7 @@ function toggleButton(element) {
### 结果
-{{EmbedLiveSample('ARIA_Toggle_Button')}}
+{{EmbedLiveSample('切换按钮示例')}}
## 无障碍考虑
From 4da20825e9f0d85239345515d36beda706c9c86b Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Thu, 3 Aug 2023 11:03:01 +0800
Subject: [PATCH 17/72] Update files/zh-cn/web/accessibility/aria/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/index.md b/files/zh-cn/web/accessibility/aria/index.md
index 7349fdfd0e5ad7..83db6cbdfdabdc 100644
--- a/files/zh-cn/web/accessibility/aria/index.md
+++ b/files/zh-cn/web/accessibility/aria/index.md
@@ -75,7 +75,7 @@ function updateProgress(percentComplete) {
```
-> **注释:** {{HTMLElement('progress')}} 元素不允许 `min` 属性,最小值永远为 0。
+> **备注:** {{HTMLElement('progress')}} 元素不允许 `min` 属性,最小值永远为 0。
> HTML 地标元素({{HTMLElement("main")}}、{{HTMLElement("header")}}、{{HTMLElement("nav")}} 等)具有内置的 ARIA 角色,因此有无需复制它们。
From f2a7644f7a47267eecd022b4c94af82b9a51ec59 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Thu, 3 Aug 2023 11:03:08 +0800
Subject: [PATCH 18/72] Update files/zh-cn/web/accessibility/aria/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/index.md b/files/zh-cn/web/accessibility/aria/index.md
index 83db6cbdfdabdc..609cda65f30939 100644
--- a/files/zh-cn/web/accessibility/aria/index.md
+++ b/files/zh-cn/web/accessibility/aria/index.md
@@ -46,7 +46,7 @@ slug: Web/Accessibility/ARIA
aria-valuemax="100">
```
-这个进度条是使用 {{HTMLElement("div")}} 构建的,没有任何意义。我们加入 ARIA 角色和属性以添加意义。在这个例子中,[`role="progressbar"`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/progressbar_role) 属性告知浏览器,这个元素实际上是一个由 JavaScript 驱动的进度条小部件。[`aria-valuemin`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-valuemin) 和 [`aria-valuemax`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-valuemax) 属性指定进度条的最小值和最大值,,[`aria-valuenow`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-valuenow) 描述进度条的当前状态和因此必须使用 JavaScript 保持更新。
+这个进度条是使用 {{HTMLElement("div")}} 构建的,没有任何意义。我们加入 ARIA 角色和属性以添加意义。在这个例子中,[`role="progressbar"`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/progressbar_role) 属性告知浏览器,这个元素实际上是一个由 JavaScript 驱动的进度条小部件。[`aria-valuemin`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-valuemin) 和 [`aria-valuemax`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-valuemax) 属性指定进度条的最小值和最大值,[`aria-valuenow`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-valuenow) 描述进度条的当前状态,因此必须使用 JavaScript 保持更新。
除了将它们直接放置在元素中之外,还可以将 ARIA 属性添加到元素中,并使用 JavaScript 代码动态更新,如下所示:
From 60fa5a0b334b74f3085203be9740ba7bdea795dd Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Thu, 3 Aug 2023 11:03:19 +0800
Subject: [PATCH 19/72] Update files/zh-cn/web/accessibility/aria/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/index.md b/files/zh-cn/web/accessibility/aria/index.md
index 609cda65f30939..57ed7a0c034e39 100644
--- a/files/zh-cn/web/accessibility/aria/index.md
+++ b/files/zh-cn/web/accessibility/aria/index.md
@@ -29,7 +29,7 @@ slug: Web/Accessibility/ARIA
它补充了 HTML,以便在没有其他机制时可以将应用程序中常用的交互和小部件传递给辅助技术。例如,ARIA 支持无障碍 JavaScript 小部件、表单提示和错误消息、实时内容更新等。
-> **警告:** 许多这些小部件在现代浏览器中都已经完全支持。如果有正确语义的 HTML 元素存在的话,**开发人员应该更喜欢使用这样的元素而不是使用 ARIA**。例如,原生元素具有内置的[键盘无障碍](/zh-CN/docs/Web/Accessibility/Keyboard-navigable_JavaScript_widgets)、角色和状态。但是,如果您选择使用 ARIA,则你有责任在脚本中模仿(等效)浏览器行为。
+> **警告:** 许多这些小部件在现代浏览器中都已经完全支持。如果有正确语义的 HTML 元素存在的话,**开发人员应该更喜欢使用这样的元素而不是使用 ARIA**。例如,原生元素具有内置的[键盘无障碍](/zh-CN/docs/Web/Accessibility/Keyboard-navigable_JavaScript_widgets)、角色和状态。但是,如果你选择使用 ARIA,则你有责任在脚本中模仿等效的浏览器行为。
使用 [ARIA 的第一规则](https://www.w3.org/TR/using-aria/#rule1)是“如果你能够使用原生的 HTML 元素或属性,并且有你需要但已经建立在里面的语义和行为,而不是重新调整元素的用途并添加 ARIA 角色、状态或者属性来使它更加无障碍,那么你就应该如此。”
From 3c2ba74e5306ae5f2acc4e72572d5187c6de5533 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Thu, 3 Aug 2023 11:03:29 +0800
Subject: [PATCH 20/72] Update files/zh-cn/web/accessibility/aria/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/index.md b/files/zh-cn/web/accessibility/aria/index.md
index 57ed7a0c034e39..f989332acf4320 100644
--- a/files/zh-cn/web/accessibility/aria/index.md
+++ b/files/zh-cn/web/accessibility/aria/index.md
@@ -77,7 +77,7 @@ function updateProgress(percentComplete) {
> **备注:** {{HTMLElement('progress')}} 元素不允许 `min` 属性,最小值永远为 0。
-> HTML 地标元素({{HTMLElement("main")}}、{{HTMLElement("header")}}、{{HTMLElement("nav")}} 等)具有内置的 ARIA 角色,因此有无需复制它们。
+> **备注:** HTML 地标元素({{HTMLElement("main")}}、{{HTMLElement("header")}}、{{HTMLElement("nav")}} 等)具有内置的 ARIA 角色,因此有无需复制它们。
## 支持
From f71c216305e91e5287c78d083c139e3eb0ba3f02 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Thu, 3 Aug 2023 11:03:40 +0800
Subject: [PATCH 21/72] Update files/zh-cn/web/accessibility/aria/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/index.md b/files/zh-cn/web/accessibility/aria/index.md
index f989332acf4320..b2933aeaceeeb9 100644
--- a/files/zh-cn/web/accessibility/aria/index.md
+++ b/files/zh-cn/web/accessibility/aria/index.md
@@ -67,7 +67,7 @@ function updateProgress(percentComplete) {
}
```
-所有对非辅助技术的可用的内容都应该对辅助技术可用。类似地,不应包含针对辅助技术用户使用但对于不使用辅助技术的用户无法访问的任何功能。这个进度条需要有相应的样式,从而看起来像进度条。
+所有对非辅助技术的可用的内容都应该对辅助技术可用。类似地,不应包含针对辅助技术用户使用但对于不使用辅助技术的用户无法访问的任何特性。这个进度条需要有相应的样式,从而看起来像进度条。
如果使用原生的 {{HTMLElement('progress')}} 元素,则会简单得多:
From ff81eba464a561e6b3e5c675507673e12919d521 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Thu, 3 Aug 2023 11:04:12 +0800
Subject: [PATCH 22/72] Update files/zh-cn/web/accessibility/aria/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/index.md b/files/zh-cn/web/accessibility/aria/index.md
index b2933aeaceeeb9..52214a81fd8a4b 100644
--- a/files/zh-cn/web/accessibility/aria/index.md
+++ b/files/zh-cn/web/accessibility/aria/index.md
@@ -33,7 +33,7 @@ slug: Web/Accessibility/ARIA
使用 [ARIA 的第一规则](https://www.w3.org/TR/using-aria/#rule1)是“如果你能够使用原生的 HTML 元素或属性,并且有你需要但已经建立在里面的语义和行为,而不是重新调整元素的用途并添加 ARIA 角色、状态或者属性来使它更加无障碍,那么你就应该如此。”
-> **备注:** 有个说法叫做“ARIA 宁缺毋滥”。在 [WebAim's survey of over one million home pages](https://webaim.org/projects/million/#aria) 中,他们发现,有 ARIA 存在的主页比那些没有 ARIA 的,多检测出了平均 41% 的错误。尽管 ARIA 是为了使网页更加无障碍而设计的,但是如果使用不当,可能适得其反。
+> **备注:** 有个说法叫做“ARIA 宁缺毋滥”。在 [WebAim 对超过 100 万个主页的调查](https://webaim.org/projects/million/#aria)中,他们发现,有 ARIA 存在的主页比那些没有 ARIA 的,多检测出了平均 41% 的错误。尽管 ARIA 是为了使网页更加无障碍而设计的,但是如果使用不当,可能适得其反。
这是进度条小部件的标记:
From 20c0eb44191697d6f735ad5961b05819f4a941fa Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Thu, 3 Aug 2023 03:13:30 +0000
Subject: [PATCH 23/72] =?UTF-8?q?=E4=BF=AE=E6=AD=A3=E4=B8=80=E4=BA=9B?=
=?UTF-8?q?=E7=BF=BB=E8=AF=91?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
files/zh-cn/web/accessibility/aria/index.md | 17 ++++-------------
1 file changed, 4 insertions(+), 13 deletions(-)
diff --git a/files/zh-cn/web/accessibility/aria/index.md b/files/zh-cn/web/accessibility/aria/index.md
index 52214a81fd8a4b..5f965273a6f0f0 100644
--- a/files/zh-cn/web/accessibility/aria/index.md
+++ b/files/zh-cn/web/accessibility/aria/index.md
@@ -81,21 +81,12 @@ function updateProgress(percentComplete) {
## 支持
-与任何其他 Web 技术一样,对 ARIA 有不同程度的支持。支持基于所使用的操作系统和浏览器,以及与之交互的辅助技术类型。此外,操作系统、浏览器和辅助技术的版本也是影响因素。较旧的软件版本可能不支持某些 ARIA 角色、仅部分支持或误报其功能。
+与任何其他 Web 技术一样,ARIA 也有不同程度的支持。支持基于所使用的操作系统和浏览器,以及与之交互的辅助技术类型。此外,操作系统、浏览器和辅助技术的版本也是影响因素。较旧的软件版本可能不支持某些 ARIA 角色、仅部分支持或误报其功能。
-同样重要的是要承认一些依赖辅助技术的人不愿意升级他们的软件,因为害怕失去与他们的计算机和浏览器交互的能力。因此,尽可能对 [使用语义化的 HTML 元素](/zh-CN/docs/Learn/Accessibility/HTML) 很重要,因为语义 HTML 对辅助技术的支持要好得多。
+同样重要的是要承认一些依赖辅助技术的人不愿意升级他们的软件,因为害怕失去与他们的计算机和浏览器交互的能力。因此,尽可能[使用语义化的 HTML 元素](/zh-CN/docs/Learn/Accessibility/HTML)很重要,因为语义 HTML 对辅助技术的支持要好得多。
使用实际辅助技术测试您编写的 ARIA 也很重要。就像浏览器模拟器和模拟器不是测试完全支持的有效解决方案一样,代理辅助技术解决方案不足以完全保证功能。
-## 教程
-
-- [ARIA 简介](/zh-CN/docs/Web/Accessibility/An_overview_of_accessible_web_applications_and_widgets)
- - : 快速介绍如何使用 ARIA 访问动态内容。另请参阅 2008 年的经典 [ARIA intro by Gez Lemon](https://dev.opera.com/articles/view/introduction-to-wai-aria/)。
-- [Videos of screen readers using ARIA](https://zomigi.com/blog/videos-of-screen-readers-using-aria-updated/)
- - : 查看来自网络的真实和简化示例,视频包括 ARIA“之前”和 ARIA“之后”。
-- [Using ARIA](https://w3c.github.io/using-aria/)
- - : 开发人员实用指南。它建议在 HTML 元素上使用哪些 ARIA 属性。建议是基于实施的实际情况。
-
## 参考
- [ARIA 角色](/zh-CN/docs/Web/Accessibility/ARIA/Roles)
@@ -105,9 +96,9 @@ function updateProgress(percentComplete) {
## 标准化工作
-- [WAI-ARIA Specification](https://www.w3.org/TR/wai-aria-1.1/)
+- [WAI-ARIA 规范](https://www.w3.org/TR/wai-aria-1.1/)
- : W3C 规范本身。
-- [WAI-ARIA Authoring Practices](https://www.w3.org/TR/wai-aria-practices-1.1/)
+- [WAI-ARIA 创作实践](https://www.w3.org/TR/wai-aria-practices-1.1/)
- : 官方最佳实践记录了如何最好地对常见小部件和交互进行 ARIA 化。一个很好的资源。
## 脚本小部件的 ARIA
From 52b4b044a3c1ca95895d689e9636eee83b974490 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Fri, 4 Aug 2023 16:40:51 +0800
Subject: [PATCH 24/72] Update
files/zh-cn/web/accessibility/aria/roles/button_role/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index bb6ffefb7f8584..c8b08e3c364fb0 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -3,7 +3,7 @@ title: ARIA:button 角色
slug: Web/Accessibility/ARIA/Roles/button_role
---
-`button` 角色应该用于可单击的元素,当用户激活时触发响应。添加 `role="button"` 会告诉屏幕阅读器这个元素是个按钮,但是不提供按钮的功能。你应该使用 {{HTMLElement("button")}} 或者 {{HTMLElement("input")}} 以及 `type="button"`。
+`button` 角色用于可单击的元素,在用户激活时触发响应。添加 `role="button"` 会告诉屏幕阅读器这个元素是个按钮,但是不提供按钮的功能。你应该使用的 {{HTMLElement("button")}} 或者 `type="button"` 的 {{HTMLElement("input")}}。
## 描述
From 19c3e043b208664a0efa415e376e61d4956f7776 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Fri, 4 Aug 2023 16:41:37 +0800
Subject: [PATCH 25/72] Update
files/zh-cn/web/accessibility/aria/roles/button_role/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index c8b08e3c364fb0..aa38b2b748648b 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -21,7 +21,7 @@ button 角色会向辅助技术(如屏幕阅读器)识别一个元素为按
保存
```
-> **备注:** 如果使用 `role="button"` 而不是语义化的 `` 或 `` 元素,你需要让这个元素可聚焦并定义事件处理器 {{domxref("Element/click_event", "click")}} 和 {{domxref("Element/keydown_event", "keydown")}}。这包括了按下 Enter 和 Space 键盘按键以处理各种形式的用户输入。参见[官方的 WAI-ARIA 示例代码](https://www.w3.org/TR/wai-aria-practices/examples/button/button.html)。
+> **备注:** 如果使用 `role="button"` 而不是语义化的 `` 或 `` 元素,你需要让这个元素可聚焦并定义 {{domxref("Element/click_event", "click")}} 和 {{domxref("Element/keydown_event", "keydown")}} 事件的事件处理器。这包括了按下 Enter 和 Space 键盘按键以处理各种形式的用户输入。参见[官方的 WAI-ARIA 示例代码](https://www.w3.org/TR/wai-aria-practices/examples/button/button.html)。
除了常见的按钮部件之外,使用非按钮元素创建切换按钮和菜单按钮时,应该使用 `role="button"`。
From 3d89f9c85792ea8b2b57e80cb61c66a27752a772 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Fri, 4 Aug 2023 16:41:57 +0800
Subject: [PATCH 26/72] Update
files/zh-cn/web/accessibility/aria/roles/button_role/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index aa38b2b748648b..fbbc997b45358d 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -9,7 +9,7 @@ slug: Web/Accessibility/ARIA/Roles/button_role
button 角色会向辅助技术(如屏幕阅读器)识别一个元素为按钮。按钮是用于执行操作的小部件,例如提交表单、打开对话框、退出活动或执行一个命令,例如插入新的记录或者显示信息。添加 `role="button"` 会告诉辅助技术,这是一个按钮,但是不提供按钮的功能。你应该使用 {{HTMLElement("button")}} 或者 {{HTMLElement("input")}} 以及 `type="button"`。
-`button` 角色可以和 [`aria-pressed`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-pressed) 特性一起使用,以[创建切换按钮](#切换按钮)。
+`button` 角色可以和 [`aria-pressed`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-pressed) 属性一起使用,以[创建切换按钮](#切换按钮)。
```html
保存
From 3321187c3f65c91145146a27e6dab1568f3b3b60 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Fri, 4 Aug 2023 16:42:57 +0800
Subject: [PATCH 27/72] Update
files/zh-cn/web/accessibility/aria/roles/button_role/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index fbbc997b45358d..5244e744c97ca4 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -33,7 +33,7 @@ button 角色会向辅助技术(如屏幕阅读器)识别一个元素为按
有些类型的用户界面元件,当呈现为平台无障碍 API 时,仅可包含文本。无障碍 API 没有呈现 `button` 中包含的语义元素的方式。要处理这个限制,浏览器会自动为任何 `button` 的后代元素应用角色 [`presentation`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/presentation_role),因为按钮这种角色不支持带有语义的子元素。
-例如,请看这个 `button` 按钮,有如下内容:
+例如,考虑以下包含标题的 `button` 元素。
```html
按钮的标题
From 18c0f1a708acd9d9fb364c7fab519f787ba258c3 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Fri, 4 Aug 2023 16:43:44 +0800
Subject: [PATCH 28/72] Update
files/zh-cn/web/accessibility/aria/roles/button_role/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index 5244e744c97ca4..50e67a52e6d9ea 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -45,7 +45,7 @@ button 角色会向辅助技术(如屏幕阅读器)识别一个元素为按
按钮的标题
```
-从辅助技术的视角来看,这个标题不存在,因为前面的代码片段在 [辅助功能树](/zh-CN/docs/Glossary/Accessibility_tree) 中相当于以下内容:
+从辅助技术的视角来看,这个标题不存在,因为前面的代码片段在[无障碍树](/zh-CN/docs/Glossary/Accessibility_tree)中相当于以下内容:
```html
按钮的标题
From 56497d18ce147e2d0ae1d8de89fa0d0433766979 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Fri, 4 Aug 2023 16:44:20 +0800
Subject: [PATCH 29/72] Update
files/zh-cn/web/accessibility/aria/roles/button_role/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index 50e67a52e6d9ea..85ef43e7f83dbc 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -54,7 +54,7 @@ button 角色会向辅助技术(如屏幕阅读器)识别一个元素为按
### 关联的 ARIA 角色、状态和属性
- [`aria-pressed`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-pressed)
- - : `aria-pressed` 属性定义的按钮是否为切换按钮。此值描述了按钮的状态。值包括 `aria-pressed="false"`(按钮还没有被按下)、`aria-pressed="true"` (按钮当前已被按下)和 `aria-pressed="mixed"` (按钮被视为部分按下)。如果此属性被忽略,或者设置为默认值 `aria-pressed="undefined"`,那么元素不支持被按下。
+ - : `aria-pressed` 属性将按钮定义为切换按钮。此值描述了按钮的状态。值包括 `aria-pressed="false"`(按钮还没有被按下)、`aria-pressed="true"`(按钮当前已被按下)和 `aria-pressed="mixed"`(按钮被视为部分按下)。如果此属性被忽略,或者设置为默认值 `aria-pressed="undefined"`,那么元素不支持被按下。
- [`aria-expanded`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-expanded)
- : 如果按钮控制了其他元素的分组,`aria-expanded` 状态指示了被控制的分组当前是被展开还是折叠。如果按钮有设置了 `aria-expanded="false"`,那么分组当前没有开,如果被展开了,则按钮会有 `aria-expanded="undefined"`,如果属性被忽略,则是不可展开。
From abcbb7a72448b9e1d14e196d3dd1eb943ebb9086 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Fri, 4 Aug 2023 16:44:44 +0800
Subject: [PATCH 30/72] Update
files/zh-cn/web/accessibility/aria/roles/button_role/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index 85ef43e7f83dbc..426c51500f362a 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -56,7 +56,7 @@ button 角色会向辅助技术(如屏幕阅读器)识别一个元素为按
- [`aria-pressed`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-pressed)
- : `aria-pressed` 属性将按钮定义为切换按钮。此值描述了按钮的状态。值包括 `aria-pressed="false"`(按钮还没有被按下)、`aria-pressed="true"`(按钮当前已被按下)和 `aria-pressed="mixed"`(按钮被视为部分按下)。如果此属性被忽略,或者设置为默认值 `aria-pressed="undefined"`,那么元素不支持被按下。
- [`aria-expanded`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-expanded)
- - : 如果按钮控制了其他元素的分组,`aria-expanded` 状态指示了被控制的分组当前是被展开还是折叠。如果按钮有设置了 `aria-expanded="false"`,那么分组当前没有开,如果被展开了,则按钮会有 `aria-expanded="undefined"`,如果属性被忽略,则是不可展开。
+ - : 如果按钮控制了其他元素的分组,`aria-expanded` 状态指示了被控制的分组当前是被展开还是折叠。如果按钮设置了 `aria-expanded="false"`,则分组当前未展开;如果按钮设置了 aria-expanded="true",则分组当前已展开;如果按钮设置了 `aria-expanded="undefined"`,则其是不可展开的。
### 基本的按钮
From 86b7ec433e436d2399446b468f5586b90c3f34c5 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Fri, 4 Aug 2023 08:54:10 +0000
Subject: [PATCH 31/72] =?UTF-8?q?=E6=9B=B4=E6=96=B0=20button=5Frule.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index bb6ffefb7f8584..9ddd75a768a51e 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -21,7 +21,7 @@ button 角色会向辅助技术(如屏幕阅读器)识别一个元素为按
保存
```
-> **备注:** 如果使用 `role="button"` 而不是语义化的 `` 或 `` 元素,你需要让这个元素可聚焦并定义事件处理器 {{domxref("Element/click_event", "click")}} 和 {{domxref("Element/keydown_event", "keydown")}}。这包括了按下 Enter 和 Space 键盘按键以处理各种形式的用户输入。参见[官方的 WAI-ARIA 示例代码](https://www.w3.org/TR/wai-aria-practices/examples/button/button.html)。
+> **备注:** 如果使用 `role="button"` 而不是语义化的 `` 或 `` 你需要让这个元素可聚焦并定义 {{domxref("Element/click_event", "click")}} 和 {{domxref("Element/keydown_event", "keydown")}} 事件的事件处理器。这包括了对按下 Enter 和 Space 的事件的处理,以处理各种形式的用户输入。参见[官方的 WAI-ARIA 示例代码](https://www.w3.org/TR/wai-aria-practices/examples/button/button.html)。
除了常见的按钮部件之外,使用非按钮元素创建切换按钮和菜单按钮时,应该使用 `role="button"`。
@@ -31,7 +31,7 @@ button 角色会向辅助技术(如屏幕阅读器)识别一个元素为按
### 所有子元素都是 presentation
-有些类型的用户界面元件,当呈现为平台无障碍 API 时,仅可包含文本。无障碍 API 没有呈现 `button` 中包含的语义元素的方式。要处理这个限制,浏览器会自动为任何 `button` 的后代元素应用角色 [`presentation`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/presentation_role),因为按钮这种角色不支持带有语义的子元素。
+有些类型的用户界面元件,呈现在平台无障碍 API 中时,仅可包含文本。无障碍 API 没有呈现 `button` 中包含的语义元素的方式。要处理这个限制,浏览器会自动为任何 `button` 的后代元素应用角色 [`presentation`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/presentation_role),因为按钮这种角色不支持带有语义的子元素。
例如,请看这个 `button` 按钮,有如下内容:
From f7a0ff77fb78928f1e7e523a90562df26502cafe Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Fri, 4 Aug 2023 17:11:29 +0800
Subject: [PATCH 32/72] Update index.md
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index 426c51500f362a..60e02839fb983e 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -21,7 +21,7 @@ button 角色会向辅助技术(如屏幕阅读器)识别一个元素为按
保存
```
-> **备注:** 如果使用 `role="button"` 而不是语义化的 `` 或 `` 元素,你需要让这个元素可聚焦并定义 {{domxref("Element/click_event", "click")}} 和 {{domxref("Element/keydown_event", "keydown")}} 事件的事件处理器。这包括了按下 Enter 和 Space 键盘按键以处理各种形式的用户输入。参见[官方的 WAI-ARIA 示例代码](https://www.w3.org/TR/wai-aria-practices/examples/button/button.html)。
+> **备注:** 如果使用 `role="button"` 而不是语义化的 `` 或 `` 你需要让这个元素可聚焦并定义 {{domxref("Element/click_event", "click")}} 和 {{domxref("Element/keydown_event", "keydown")}} 事件的事件处理器。这包括了对按下 Enter 和 Space 的事件的处理,以处理各种形式的用户输入。参见[官方的 WAI-ARIA 示例代码](https://www.w3.org/TR/wai-aria-practices/examples/button/button.html)。
除了常见的按钮部件之外,使用非按钮元素创建切换按钮和菜单按钮时,应该使用 `role="button"`。
@@ -31,7 +31,7 @@ button 角色会向辅助技术(如屏幕阅读器)识别一个元素为按
### 所有子元素都是 presentation
-有些类型的用户界面元件,当呈现为平台无障碍 API 时,仅可包含文本。无障碍 API 没有呈现 `button` 中包含的语义元素的方式。要处理这个限制,浏览器会自动为任何 `button` 的后代元素应用角色 [`presentation`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/presentation_role),因为按钮这种角色不支持带有语义的子元素。
+有些类型的用户界面元件,呈现在平台无障碍 API 中时,仅可包含文本。无障碍 API 没有呈现 `button` 中包含的语义元素的方式。要处理这个限制,浏览器会自动为任何 `button` 的后代元素应用角色 [`presentation`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/presentation_role),因为按钮这种角色不支持带有语义的子元素。
例如,考虑以下包含标题的 `button` 元素。
From d6188613b3d45c4240605fe43d0b0a2af0e39d2b Mon Sep 17 00:00:00 2001
From: A1lo
Date: Mon, 7 Aug 2023 21:01:44 +0800
Subject: [PATCH 33/72] Update index.md
---
.../web/accessibility/aria/roles/listitem_role/index.md | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md b/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md
index 89ace03eedb243..e0f839cca04ac7 100644
--- a/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md
@@ -1,5 +1,5 @@
---
-title: "ARIA: listitem 角色"
+title: ARIA:listitem 角色
slug: Web/Accessibility/ARIA/Roles/listitem_role
---
@@ -17,9 +17,9 @@ ARIA `listitem` 角色可用于标识项目列表中的项目。它通常与 [`l
任何由外部容器和内部元素列表组成的内容都可以分别使用 `list` 和 `listitem` 容器识别为辅助技术。
-关于应该使用哪些元素来标记 `list` 和 `listitem` 没有硬性规定,但是您应该确保 `listitem` 在列表的上下文中有意义,例如购物清单、食谱步骤、行车路线。
+关于应该使用哪些元素来标记列表和列表项没有硬性规定,但是你应该确保列表项在列表的上下文中有意义,例如购物清单、食谱步骤、行车路线。
-> **警告:** 如果可能,您应该使用适当的语义化 HTML 元素来标记 `list` 及其 `listitem`,如 {{HTMLElement("ul")}}、{{HTMLElement("ol")}} 和 {{HTMLElement("li")}}。有关完整示例,请参阅 [最佳实践](#best_practices)。
+> **备注:** 如果可能,你应该使用适当的语义化 HTML 元素来标记列表及列表项,如 {{HTMLElement("ul")}}、{{HTMLElement("ol")}} 和 {{HTMLElement("li")}}。有关完整示例,请参阅[最佳实践](#最佳实践)。
### 关联的 WAI-ARIA 角色、状态和属性
From 9575bd893eeba410f94c1f5fc04294147338c756 Mon Sep 17 00:00:00 2001
From: A1lo
Date: Mon, 7 Aug 2023 21:05:45 +0800
Subject: [PATCH 34/72] Update index.md
---
files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md b/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md
index e0f839cca04ac7..98068e817fc1fb 100644
--- a/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md
@@ -75,7 +75,7 @@ ARIA `listitem` 角色可用于标识项目列表中的项目。它通常与 [`l
-1. [**WAI-ARIA roles**](/zh-CN/docs/Web/Accessibility/ARIA/Roles)
+1. [**WAI-ARIA 角色**](/zh-CN/docs/Web/Accessibility/ARIA/Roles)
{{ListSubpagesForSidebar("/zh-CN/docs/Web/Accessibility/ARIA/Roles")}}
From 6d93a9b5e4ae905125dba47a8685a5b233e84651 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Mon, 7 Aug 2023 21:38:04 +0800
Subject: [PATCH 35/72] Update
files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md b/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md
index 98068e817fc1fb..fc990eede9e620 100644
--- a/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md
@@ -3,7 +3,7 @@ title: ARIA:listitem 角色
slug: Web/Accessibility/ARIA/Roles/listitem_role
---
-ARIA `listitem` 角色可用于标识项目列表中的项目。它通常与 [`list`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/list_role) 角色结合使用,用于标识列表容器。
+ARIA `listitem` 角色可用于标识项目列表中的项目。它通常与 [`list`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/list_role) 角色(用于标识列表容器)结合使用。
```html
From 399ffe3bae6a2d25de514c092434bc8c4b4e217c Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Mon, 7 Aug 2023 21:38:12 +0800
Subject: [PATCH 36/72] Update
files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md b/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md
index fc990eede9e620..194ec069c5fc0a 100644
--- a/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md
@@ -54,7 +54,7 @@ ARIA `listitem` 角色可用于标识项目列表中的项目。它通常与 [`l
> **备注:** ARIA `list` / `listitem` 角色不区分有序列表和无序列表。
-> **备注:** 给列表添加 CSS 样式 `list-style: none;` 移除列表语义。添加 `role="listitem"` 返回列表语义。
+> **备注:** 给列表添加 CSS 样式 `list-style: none;` 移除列表语义。添加 `role="listitem"` 获得列表语义。
> **备注:** 如果要标记将用作选项卡式界面的项目列表,则应改为使用 `tab`、`tabpanel` 和 `tablist` 角色。
From ddded78099b14d2d52861dd8b30821fd4ba38ad7 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Mon, 7 Aug 2023 21:38:20 +0800
Subject: [PATCH 37/72] Update
files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md b/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md
index 194ec069c5fc0a..38a1b02e3afcf4 100644
--- a/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/listitem_role/index.md
@@ -32,7 +32,7 @@ ARIA `listitem` 角色可用于标识项目列表中的项目。它通常与 [`l
仅在必要时使用 `role="list"` 和 `role="listitem"`。例如,无法控制 HTML 但能够在之后动态使用 JavaScript 提升无障碍的时候。
-与 HTML {{HTMLElement("ol")}} 和 {{HTMLElement("ul")}} 不同,ARIA `list` 角色不区分有序列表和无序列表。如果可能,您应该使用适当的语义 HTML 元素来标记列表({{HTMLElement("ol")}} 和 {{HTMLElement("ul")}})和列表项({{HTMLElement("li")}})。例如,我们上面的例子应该改写如下:
+与 HTML {{HTMLElement("ol")}} 和 {{HTMLElement("ul")}} 不同,ARIA `list` 角色不区分有序列表和无序列表。如果可能,你应该使用适当的语义 HTML 元素来标记列表({{HTMLElement("ol")}} 和 {{HTMLElement("ul")}})和列表项({{HTMLElement("li")}})。例如,我们上面的例子应该改写如下:
```html
From 24c2ff3c4dee138eca0be636277c9f4b620a515c Mon Sep 17 00:00:00 2001
From: A1lo
Date: Mon, 7 Aug 2023 22:48:09 +0800
Subject: [PATCH 38/72] Apply suggestions from code review
---
files/zh-cn/web/accessibility/aria/roles/list_role/index.md | 6 +++---
.../web/accessibility/aria/roles/listbox_role/index.md | 2 +-
2 files changed, 4 insertions(+), 4 deletions(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/list_role/index.md b/files/zh-cn/web/accessibility/aria/roles/list_role/index.md
index a4a3ab70315b82..f8dc8f4bcc6a22 100644
--- a/files/zh-cn/web/accessibility/aria/roles/list_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/list_role/index.md
@@ -1,5 +1,5 @@
---
-title: "ARIA:list 角色"
+title: ARIA:list 角色
slug: Web/Accessibility/ARIA/Roles/list_role
---
@@ -66,10 +66,10 @@ ARIA `list` 角色可用于标识项目列表。它通常与 `listitem` 角色
- {{HTMLElement("ul")}} 元素
- {{HTMLElement("ol")}} 元素
-- The {{HTMLElement("li")}} 元素
+- {{HTMLElement("li")}} 元素
- [ARIA:listitem 角色](/zh-CN/docs/Web/Accessibility/ARIA/Roles/listitem_role)
- [ARIA:group 角色](/zh-CN/docs/Web/Accessibility/ARIA/Roles/group_role)
-- [ARIA 列表示例](https://www.scottohara.me/blog/2018/05/26/aria-lists.html) — by Scott O'Hara
+- [ARIA 列表示例](https://www.scottohara.me/blog/2018/05/26/aria-lists.html)——由 Scott O'Hara 撰写
- [Accessibility Object Model](https://wicg.github.io/aom/spec/)
- [ARIA in HTML](https://w3c.github.io/html-aria/)
diff --git a/files/zh-cn/web/accessibility/aria/roles/listbox_role/index.md b/files/zh-cn/web/accessibility/aria/roles/listbox_role/index.md
index f15a676ecbeccf..51a7c49c7e40a0 100644
--- a/files/zh-cn/web/accessibility/aria/roles/listbox_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/listbox_role/index.md
@@ -1,5 +1,5 @@
---
-title: "ARIA:listbox 角色"
+title: ARIA:listbox 角色
slug: Web/Accessibility/ARIA/Roles/listbox_role
---
From dbcd0540aaedd7f6d641a8298e36afe8b0f764ac Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 10:35:17 +0800
Subject: [PATCH 39/72] Update
files/zh-cn/web/accessibility/aria/roles/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/index.md b/files/zh-cn/web/accessibility/aria/roles/index.md
index 489445e4283ae0..74bd0634fd0406 100644
--- a/files/zh-cn/web/accessibility/aria/roles/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/index.md
@@ -5,7 +5,7 @@ slug: Web/Accessibility/ARIA/Roles
ARIA 角色为内容提供了语义,允许屏幕阅读器和其他工具与对象类型的用户预期一致的方式进行呈现并支持交互。ARIA 角色可以用于描述不在 HTML 中原生存在的元素,或者存在但没有完整的浏览器支持的元素。
-默认情况下,很多语义的 HTML 元素都有角色,例如,`` 有 `radio` 角色。HTML 的非语义的元素没有角色,例如没有添加语义的 `` 和 `
` 会返回 `null`。`role` 属性可以添加语义。
+默认情况下,很多语义的 HTML 元素都有角色,例如,`` 有“radio”角色。HTML 的非语义的元素没有角色,例如没有添加语义的 `` 和 `
` 会返回 `null`。`role` 属性可以添加语义。
将 ARIA 角色添加到 HTML 元素的方法是使用 `role="角色类型"`,其中 _角色类型_ 是角色在 ARIA 规范中的名称。有些角色需要包含相关的状态或属性;其他这些仅在与其他角色关联时有用。
From c57e621ef754363e1472f468a04a6a7fc1686fa1 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 10:35:28 +0800
Subject: [PATCH 40/72] Update
files/zh-cn/web/accessibility/aria/roles/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/index.md b/files/zh-cn/web/accessibility/aria/roles/index.md
index 74bd0634fd0406..729ad4718afcc1 100644
--- a/files/zh-cn/web/accessibility/aria/roles/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/index.md
@@ -9,7 +9,7 @@ ARIA 角色为内容提供了语义,允许屏幕阅读器和其他工具与对
将 ARIA 角色添加到 HTML 元素的方法是使用 `role="角色类型"`,其中 _角色类型_ 是角色在 ARIA 规范中的名称。有些角色需要包含相关的状态或属性;其他这些仅在与其他角色关联时有用。
-例如,`` 会被屏幕阅读器读作“标签面板(tab panel)”。但是,如果标签页面没有嵌套的标签,带有标签页面角色的元素实际上并不是个标签面板,从而辅助技术产生负面影响。
+例如,`` 会被屏幕阅读器读作“标签面板(tab panel)”。但是,如果标签页面没有嵌套的标签,带有标签页面角色的元素实际上并不是个标签面板,从而对无障碍造成负面影响。
各角色的页面中都包含了相关的 [ARIA 状态和属性](/zh-CN/docs/Web/Accessibility/ARIA/Attributes),以及带有相应页面的各个属性。
From 27bf627ec2d31ab246c7a74499e2627d630e17c8 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 10:35:47 +0800
Subject: [PATCH 41/72] Update
files/zh-cn/web/accessibility/aria/roles/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/index.md b/files/zh-cn/web/accessibility/aria/roles/index.md
index 729ad4718afcc1..854b00e1e97278 100644
--- a/files/zh-cn/web/accessibility/aria/roles/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/index.md
@@ -7,7 +7,7 @@ ARIA 角色为内容提供了语义,允许屏幕阅读器和其他工具与对
默认情况下,很多语义的 HTML 元素都有角色,例如,`` 有“radio”角色。HTML 的非语义的元素没有角色,例如没有添加语义的 `` 和 `
` 会返回 `null`。`role` 属性可以添加语义。
-将 ARIA 角色添加到 HTML 元素的方法是使用 `role="角色类型"`,其中 _角色类型_ 是角色在 ARIA 规范中的名称。有些角色需要包含相关的状态或属性;其他这些仅在与其他角色关联时有用。
+将 ARIA 角色添加到 HTML 元素的方法是使用 `role="角色类型"`,其中*角色类型*是角色在 ARIA 规范中的名称。有些角色需要包含相关的状态或属性;其他这些仅在与其他角色关联时有用。
例如,`` 会被屏幕阅读器读作“标签面板(tab panel)”。但是,如果标签页面没有嵌套的标签,带有标签页面角色的元素实际上并不是个标签面板,从而对无障碍造成负面影响。
From 92c8a09e7cb8e01ed0fbe89b4cf19a7f1659af81 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 10:35:59 +0800
Subject: [PATCH 42/72] Update
files/zh-cn/web/accessibility/aria/roles/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/index.md b/files/zh-cn/web/accessibility/aria/roles/index.md
index 854b00e1e97278..14ad75bc4d43e9 100644
--- a/files/zh-cn/web/accessibility/aria/roles/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/index.md
@@ -11,7 +11,7 @@ ARIA 角色为内容提供了语义,允许屏幕阅读器和其他工具与对
例如,`` 会被屏幕阅读器读作“标签面板(tab panel)”。但是,如果标签页面没有嵌套的标签,带有标签页面角色的元素实际上并不是个标签面板,从而对无障碍造成负面影响。
-各角色的页面中都包含了相关的 [ARIA 状态和属性](/zh-CN/docs/Web/Accessibility/ARIA/Attributes),以及带有相应页面的各个属性。
+各角色的页面中都包含了相关的 [ARIA 状态和属性](/zh-CN/docs/Web/Accessibility/ARIA/Attributes),而每个属性都有一个专门的页面。
## ARIA 角色类型
From 69a3eb215762de567f42d7adfdfa9a29effebb04 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 10:37:52 +0800
Subject: [PATCH 43/72] Update
files/zh-cn/web/accessibility/aria/roles/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/index.md b/files/zh-cn/web/accessibility/aria/roles/index.md
index 14ad75bc4d43e9..4c2565963a887f 100644
--- a/files/zh-cn/web/accessibility/aria/roles/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/index.md
@@ -19,7 +19,7 @@ ARIA 角色共分为 6 类:
### 1. 文档结构角色
-文档结构角色用于给内容的段落添加一个结构的描述。这些角色大多数都不应该再使用,因为浏览器现在支持带有相同的含义的语义的 HTML 元素。没有相应 HTML 等价的角色,例如 presentation、toolbar 和 tooltip 角色,为辅助技术(例如屏幕阅读器)提供了文档结构信息,而这些信息是没有可用的原生 HTML 的。
+文档结构角色用于给内容的段落添加一个结构的描述。这些角色大多数都不应该再使用,因为浏览器现在支持带有相同的含义的语义化 HTML 元素。没有相应 HTML 等价的角色,例如 presentation、toolbar 和 tooltip 角色,为辅助技术(例如屏幕阅读器)提供了文档结构信息,而这些信息没有可用的原生 HTML。
- [toolbar](/zh-CN/docs/Web/Accessibility/ARIA/Roles/toolbar_role)
- [tooltip](/zh-CN/docs/Web/Accessibility/ARIA/Roles/tooltip_role)
From 6f9d1206080ff97ae9387ae15e401cc75b5d0bc0 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 10:39:36 +0800
Subject: [PATCH 44/72] Update
files/zh-cn/web/accessibility/aria/roles/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/index.md b/files/zh-cn/web/accessibility/aria/roles/index.md
index 4c2565963a887f..ecfa54ef1dfda7 100644
--- a/files/zh-cn/web/accessibility/aria/roles/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/index.md
@@ -112,7 +112,7 @@ ARIA 角色共分为 6 类:
### 4. 实时区域角色
-实时区域角色用于定义带有动态更改的内容的元素。动态变化在视觉上明显时,具有视力的的用户可以看到。这些角色可帮助低视力和盲人用户了解内容是否已更新。辅助技术,例如屏幕阅读器,可以读出动态内容更改:
+实时区域(Live Region)角色用于定义带有动态更改的内容的元素。动态变化在视觉上明显时,具有视力的的用户可以看到。这些角色可帮助低视力和盲人用户了解内容是否更新。辅助技术,例如屏幕阅读器,可以告知动态内容变更:
- [alert](/zh-CN/docs/Web/Accessibility/ARIA/Roles/alert_role)
- [log](/zh-CN/docs/Web/Accessibility/ARIA/Roles/log_role)
From 16052c3e9d6c1bbf8b7058b053a1408de0039037 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 10:40:00 +0800
Subject: [PATCH 45/72] Update
files/zh-cn/web/accessibility/aria/roles/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/index.md b/files/zh-cn/web/accessibility/aria/roles/index.md
index ecfa54ef1dfda7..6bfaa6e72657a4 100644
--- a/files/zh-cn/web/accessibility/aria/roles/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/index.md
@@ -99,7 +99,7 @@ ARIA 角色共分为 6 类:
### 3. 地标角色
-地标角色提供了一种识别网页的组织和结构的方法。对页面的各个部分进行分类并加标,可以以编程方式呈现出通过布局直观传达的结构信息。屏幕阅读器使用地标角色为页面的重要部分提供键盘导航。谨慎使用这些。太多的地标角色会在屏幕阅读器中产生“噪音”,导致难以理解页面的整体布局。
+地标(landmark)角色提供了一种识别网页的组织和结构的方法。对页面的各个部分进行分类并添加标签,可以用编程方式呈现出通过布局直观传达的结构信息。屏幕阅读器使用地标角色为页面的重要部分提供键盘导航。谨慎使用这些。太多的地标角色会在屏幕阅读器中产生“噪音”,导致难以理解页面的整体布局。
- [banner](/zh-CN/docs/Web/Accessibility/ARIA/Roles/banner_role) (文档 {{HTMLElement('header')}})
- [complementary](/zh-CN/docs/Web/Accessibility/ARIA/Roles/complementary_role)({{HTMLElement('aside')}})
From 01c7667af27351039808975c2e26ecc5a09a5a7e Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 10:40:14 +0800
Subject: [PATCH 46/72] Update
files/zh-cn/web/accessibility/aria/roles/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/index.md b/files/zh-cn/web/accessibility/aria/roles/index.md
index 6bfaa6e72657a4..988049497aa4e9 100644
--- a/files/zh-cn/web/accessibility/aria/roles/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/index.md
@@ -122,7 +122,7 @@ ARIA 角色共分为 6 类:
### 5. 窗口角色
-窗口角色为同一文档内的主文档窗口定义了子窗口,例如弹出模式对话框:
+窗口角色为同一文档内的主文档窗口定义了子窗口,例如弹出模态框:
- [alertdialog](/zh-CN/docs/Web/Accessibility/ARIA/Roles/alertdialog_role)
- [dialog](/zh-CN/docs/Web/Accessibility/ARIA/Roles/dialog_role)
From dce6daeaff99fcf979f9da17d86f27ba801c9bf6 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 10:40:22 +0800
Subject: [PATCH 47/72] Update
files/zh-cn/web/accessibility/aria/roles/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/index.md b/files/zh-cn/web/accessibility/aria/roles/index.md
index 988049497aa4e9..6930eed4fe2b7b 100644
--- a/files/zh-cn/web/accessibility/aria/roles/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/index.md
@@ -150,7 +150,7 @@ ARIA 角色共分为 6 类:
-1. [**WAI-ARIA roles**](/zh-CN/docs/Web/Accessibility/ARIA/Roles)
+1. [**WAI-ARIA 角色**](/zh-CN/docs/Web/Accessibility/ARIA/Roles)
{{ListSubpagesForSidebar("/zh-CN/docs/Web/Accessibility/ARIA/Roles")}}
From f6d6da38645acbae8620f337a5799fd66f25954a Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 10:40:43 +0800
Subject: [PATCH 48/72] Update
files/zh-cn/web/accessibility/aria/roles/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/index.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/index.md b/files/zh-cn/web/accessibility/aria/roles/index.md
index 6930eed4fe2b7b..800b01b68f363c 100644
--- a/files/zh-cn/web/accessibility/aria/roles/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/index.md
@@ -133,9 +133,9 @@ ARIA 角色共分为 6 类:
避免使用[command](/zh-CN/docs/Web/Accessibility/ARIA/Roles/command_role)、[composite](/zh-CN/docs/Web/Accessibility/ARIA/Roles/composite_role)、[input](/zh-CN/docs/Web/Accessibility/ARIA/Roles/input_role)、[landmark](/zh-CN/docs/Web/Accessibility/ARIA/Roles/landmark_role)、[range](/zh-CN/docs/Web/Accessibility/ARIA/Roles/range_role)、[roletype](/zh-CN/docs/Web/Accessibility/ARIA/Roles/roletype_role)、[section](/zh-CN/docs/Web/Accessibility/ARIA/Roles/section_role)、[sectionhead](/zh-CN/docs/Web/Accessibility/ARIA/Roles/sectionhead_role)、[select](/zh-CN/docs/Web/Accessibility/ARIA/Roles/select_role)、[structure](/zh-CN/docs/Web/Accessibility/ARIA/Roles/structure_role)、[widget](/zh-CN/docs/Web/Accessibility/ARIA/Roles/widget_role) 和 [window](/zh-CN/docs/Web/Accessibility/ARIA/Roles/window_role)。
-> **Note:** 不要在你的网站和应用中使用抽象角色。抽象角色是由浏览器使用的,这里列出来仅用于参考。
+> **备注:** 不要在你的网站和应用中使用抽象角色。抽象角色是由浏览器使用的,这里列出来仅用于参考。
-> **Warning:** “Abstract roles are used for the ontology. Authors **MUST NOT** use abstract roles in content.” ——WAI-ARIA 规定
+> **警告:**“抽象角色用于本体。作者**不得**在内容中使用抽象角色。” ——WAI-ARIA 规范
## MDN 中定义的角色
From 9c25e28238e1453a66135bdf861184123bdbf8fd Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 10:41:06 +0800
Subject: [PATCH 49/72] Update
files/zh-cn/web/accessibility/aria/roles/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/index.md b/files/zh-cn/web/accessibility/aria/roles/index.md
index 800b01b68f363c..fb29baf78c0fb0 100644
--- a/files/zh-cn/web/accessibility/aria/roles/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/index.md
@@ -28,7 +28,7 @@ ARIA 角色共分为 6 类:
- [presentation](/zh-CN/docs/Web/Accessibility/ARIA/Roles/presentation_role) / [none](/zh-CN/docs/Web/Accessibility/ARIA/Roles/none_role)
- [note](/zh-CN/docs/Web/Accessibility/ARIA/Roles/note_role)
-对于大多数结构角色,都有可用且受支持的等价的语义 HTML。请避免使用:
+对于大多数结构角色,都有可用、受支持且等价的语义化 HTML 元素。请避免使用:
- [application](/zh-CN/docs/Web/Accessibility/ARIA/Roles/application_role)
- [article](/zh-CN/docs/Web/Accessibility/ARIA/Roles/article_role)(请使用 {{HTMLElement('article')}})
From 5b04d37f9c1a1289ede8906ce217b4842148e9ab Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 10:41:30 +0800
Subject: [PATCH 50/72] Update
files/zh-cn/web/accessibility/aria/roles/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/index.md b/files/zh-cn/web/accessibility/aria/roles/index.md
index fb29baf78c0fb0..c3d25f51939d98 100644
--- a/files/zh-cn/web/accessibility/aria/roles/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/index.md
@@ -70,7 +70,7 @@ ARIA 角色共分为 6 类:
### 2. 小部件角色
-各种小部件角色用于定义常见的交互模式。类似于文档结构角色,有些这些角色与同样受支持的语义原生 HTML 是重复的,因此不应该使用。这两个列表的区别在于,通常来说,小部件角色需要 JavaScript 交互,而文档结构角色通常不需要。
+各种小部件角色用于定义常见的交互模式。类似于文档结构角色,有些这些角色与同样受支持的原生 HTML 的语义是重复的,因此不应该使用。这两个列表的区别在于,通常来说,小部件角色需要 JavaScript 交互,而文档结构角色不需要。
- [scrollbar](/zh-CN/docs/Web/Accessibility/ARIA/Roles/scrollbar_role)
- [searchbox](/zh-CN/docs/Web/Accessibility/ARIA/Roles/searchbox_role)
From c2b1a754a00055ec7e0d2d23c4e2ca7098377ac4 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 10:41:46 +0800
Subject: [PATCH 51/72] Update
files/zh-cn/web/accessibility/aria/roles/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/index.md b/files/zh-cn/web/accessibility/aria/roles/index.md
index c3d25f51939d98..ce63b4332b4b4e 100644
--- a/files/zh-cn/web/accessibility/aria/roles/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/index.md
@@ -74,7 +74,7 @@ ARIA 角色共分为 6 类:
- [scrollbar](/zh-CN/docs/Web/Accessibility/ARIA/Roles/scrollbar_role)
- [searchbox](/zh-CN/docs/Web/Accessibility/ARIA/Roles/searchbox_role)
-- [separator](/zh-CN/docs/Web/Accessibility/ARIA/Roles/separator_role) (when focusable)
+- [separator](/zh-CN/docs/Web/Accessibility/ARIA/Roles/separator_role)(如果可以聚焦)
- [slider](/zh-CN/docs/Web/Accessibility/ARIA/Roles/slider_role)
- [spinbutton](/zh-CN/docs/Web/Accessibility/ARIA/Roles/spinbutton_role)
- [switch](/zh-CN/docs/Web/Accessibility/ARIA/Roles/switch_role)
From 442ebdda3a5fd0f256304879bc7cd26ea0723b2b Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 10:42:00 +0800
Subject: [PATCH 52/72] Update
files/zh-cn/web/accessibility/aria/roles/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/index.md b/files/zh-cn/web/accessibility/aria/roles/index.md
index ce63b4332b4b4e..b299e55641474d 100644
--- a/files/zh-cn/web/accessibility/aria/roles/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/index.md
@@ -47,7 +47,7 @@ ARIA 角色共分为 6 类:
- [row](/zh-CN/docs/Web/Accessibility/ARIA/Roles/row_role)(请使用 {{HTMLElement('tr')}} 和 {{HTMLElement('table')}})
- [rowgroup](/zh-CN/docs/Web/Accessibility/ARIA/Roles/rowgroup_role)(请使用 {{HTMLElement('thead')}}、{{HTMLElement('tfoot')}} 和 {{HTMLElement('tbody')}})
- [rowheader](/zh-CN/docs/Web/Accessibility/ARIA/Roles/rowheader_role)(请使用 `{{HTMLElement('th','<th scope="row">')}}`)
-- [separator](/zh-CN/docs/Web/Accessibility/ARIA/Roles/separator_role)(请使用 {{HTMLElement('hr')}} 如果它没有焦点)
+- [separator](/zh-CN/docs/Web/Accessibility/ARIA/Roles/separator_role)(如果不可以聚焦,请使用 {{HTMLElement('hr')}})
- [table](/zh-CN/docs/Web/Accessibility/ARIA/Roles/table_role)(请使用 {{HTMLElement('table')}})
- [term](/zh-CN/docs/Web/Accessibility/ARIA/Roles/term_role)(请使用 {{HTMLElement('dfn')}})
From 3b14df52405ef9ead0bb00022ebea18d6374d7ab Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 10:42:14 +0800
Subject: [PATCH 53/72] Update
files/zh-cn/web/accessibility/aria/roles/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/index.md b/files/zh-cn/web/accessibility/aria/roles/index.md
index b299e55641474d..861045831e1fbb 100644
--- a/files/zh-cn/web/accessibility/aria/roles/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/index.md
@@ -82,7 +82,7 @@ ARIA 角色共分为 6 类:
- [tabpanel](/zh-CN/docs/Web/Accessibility/ARIA/Roles/tabpanel_role)
- [treeitem](/zh-CN/docs/Web/Accessibility/ARIA/Roles/treeitem_role)
-避免使用 [button](/zh-CN/docs/Web/Accessibility/ARIA/Roles/button_role)、[checkbox](/zh-CN/docs/Web/Accessibility/ARIA/Roles/checkbox_role)、[gridcell](/zh-CN/docs/Web/Accessibility/ARIA/Roles/gridcell_role)、[link](/zh-CN/docs/Web/Accessibility/ARIA/Roles/link_role)、[menuitem](/zh-CN/docs/Web/Accessibility/ARIA/Roles/menuitem_role)、[menuitemcheckbox](/zh-CN/docs/Web/Accessibility/ARIA/Roles/menuitemcheckbox_role)、[menuitemradio](/zh-CN/docs/Web/Accessibility/ARIA/Roles/menuitemradio_role)、[option](/zh-CN/docs/Web/Accessibility/ARIA/Roles/option_role)、[progressbar](/zh-CN/docs/Web/Accessibility/ARIA/Roles/progressbar_role)、[radio](/zh-CN/docs/Web/Accessibility/ARIA/Roles/radio_role)和 [textbox](/zh-CN/docs/Web/Accessibility/ARIA/Roles/textbox_role),这些仅为完整性而包含。大多数情况下,带有无障碍的交互性的语义等价也是可用且受支持的。更多信息,请参见其各自的角色文档。
+避免使用 [button](/zh-CN/docs/Web/Accessibility/ARIA/Roles/button_role)、[checkbox](/zh-CN/docs/Web/Accessibility/ARIA/Roles/checkbox_role)、[gridcell](/zh-CN/docs/Web/Accessibility/ARIA/Roles/gridcell_role)、[link](/zh-CN/docs/Web/Accessibility/ARIA/Roles/link_role)、[menuitem](/zh-CN/docs/Web/Accessibility/ARIA/Roles/menuitem_role)、[menuitemcheckbox](/zh-CN/docs/Web/Accessibility/ARIA/Roles/menuitemcheckbox_role)、[menuitemradio](/zh-CN/docs/Web/Accessibility/ARIA/Roles/menuitemradio_role)、[option](/zh-CN/docs/Web/Accessibility/ARIA/Roles/option_role)、[progressbar](/zh-CN/docs/Web/Accessibility/ARIA/Roles/progressbar_role)、[radio](/zh-CN/docs/Web/Accessibility/ARIA/Roles/radio_role)和 [textbox](/zh-CN/docs/Web/Accessibility/ARIA/Roles/textbox_role),这些仅为完整性而包含。大多数情况下,带有无障碍的交互性的语义等价也是可用且受支持的。更多信息,请参见其各个角色的文档。
#### 复合小部件角色
From 32fa6a127c0cded094cab6611f9c1ec85b3265ae Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 10:42:26 +0800
Subject: [PATCH 54/72] Update
files/zh-cn/web/accessibility/aria/roles/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/index.md b/files/zh-cn/web/accessibility/aria/roles/index.md
index 861045831e1fbb..630af45c884711 100644
--- a/files/zh-cn/web/accessibility/aria/roles/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/index.md
@@ -93,7 +93,7 @@ ARIA 角色共分为 6 类:
- [tree](/zh-CN/docs/Web/Accessibility/ARIA/Roles/tree_role)
- [treegrid](/zh-CN/docs/Web/Accessibility/ARIA/Roles/treegrid_role)
-避免使用 [grid](/zh-CN/docs/Web/Accessibility/ARIA/Roles/grid_role)、[listbox](/zh-CN/docs/Web/Accessibility/ARIA/Roles/listbox_role) 和 [radiogroup](/zh-CN/docs/Web/Accessibility/ARIA/Roles/radio_role),这些仅为完整性而包含。更多信息,请参见其各自的角色文档。
+避免使用 [grid](/zh-CN/docs/Web/Accessibility/ARIA/Roles/grid_role)、[listbox](/zh-CN/docs/Web/Accessibility/ARIA/Roles/listbox_role) 和 [radiogroup](/zh-CN/docs/Web/Accessibility/ARIA/Roles/radio_role),这些仅为完整性而包含。更多信息,请参见其各个角色的文档。
注意还有个 widget 角色(`role="widget"`),这是个抽象的角色,不在小部件角色类别中。
From 660062f823600a918f96eaf72268b967ef633d12 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 10:53:45 +0800
Subject: [PATCH 55/72] Update index.md
translation of "presentation"
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index 60e02839fb983e..384d75cbbc9ca9 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -29,7 +29,7 @@ button 角色会向辅助技术(如屏幕阅读器)识别一个元素为按
菜单按钮是指控制一个菜单且 [`aria-haspopup`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-haspopup) 属性设置为 `menu` 或 `true` 的按钮。
-### 所有子元素都是 presentation
+### 所有子元素都是仅作展示的
有些类型的用户界面元件,呈现在平台无障碍 API 中时,仅可包含文本。无障碍 API 没有呈现 `button` 中包含的语义元素的方式。要处理这个限制,浏览器会自动为任何 `button` 的后代元素应用角色 [`presentation`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/presentation_role),因为按钮这种角色不支持带有语义的子元素。
@@ -39,7 +39,7 @@ button 角色会向辅助技术(如屏幕阅读器)识别一个元素为按
按钮的标题
```
-由于 `button` 的子元素都是 presentation,因此相当于以下的代码:
+由于 `button` 的子元素都是仅作展示的,因此相当于以下的代码:
```html
按钮的标题
From 7a7984a80175ac9a3a878da840b5ffbd5320281f Mon Sep 17 00:00:00 2001
From: A1lo
Date: Tue, 8 Aug 2023 11:15:52 +0800
Subject: [PATCH 56/72] Update
files/zh-cn/web/accessibility/aria/roles/button_role/index.md
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index 384d75cbbc9ca9..8a40f33a398f23 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -56,7 +56,7 @@ button 角色会向辅助技术(如屏幕阅读器)识别一个元素为按
- [`aria-pressed`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-pressed)
- : `aria-pressed` 属性将按钮定义为切换按钮。此值描述了按钮的状态。值包括 `aria-pressed="false"`(按钮还没有被按下)、`aria-pressed="true"`(按钮当前已被按下)和 `aria-pressed="mixed"`(按钮被视为部分按下)。如果此属性被忽略,或者设置为默认值 `aria-pressed="undefined"`,那么元素不支持被按下。
- [`aria-expanded`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-expanded)
- - : 如果按钮控制了其他元素的分组,`aria-expanded` 状态指示了被控制的分组当前是被展开还是折叠。如果按钮设置了 `aria-expanded="false"`,则分组当前未展开;如果按钮设置了 aria-expanded="true",则分组当前已展开;如果按钮设置了 `aria-expanded="undefined"`,则其是不可展开的。
+ - : 如果按钮控制了其他元素的分组,`aria-expanded` 状态指示了被控制的分组当前是被展开还是折叠。如果按钮设置了 `aria-expanded="false"`,则分组当前未展开;如果按钮设置了 `aria-expanded="true"`,则分组当前已展开;如果按钮设置了 `aria-expanded="undefined"`,则其是不可展开的。
### 基本的按钮
From 536e3e4d06c8049dde3699c1ba2a778c4d707ddd Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 13:31:18 +0800
Subject: [PATCH 57/72] Update
files/zh-cn/web/accessibility/aria/roles/button_role/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index 8a40f33a398f23..89e0e1e7fcc59c 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -64,7 +64,7 @@ button 角色会向辅助技术(如屏幕阅读器)识别一个元素为按
## 切换按钮
-切换按钮通常有两种状态:按下、没有按下,第三个混合的状是指,切换按钮控制了其他的元素,例如其他的切换按钮或者复选框,而不共享同一个值。按钮是否被按下可以由 `button` 角色(如果元素还不是原生的 button 元素)加上 [`aria-pressed`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-pressed) 表示:
+切换按钮通常有两种状态:按下、没有按下,第三种混合状态可用于控制了其他的元素的切换按钮,例如其他的不共享同一个值的切换按钮或者复选框。还可以使用 `button` 角色(如果元素不是原生的 button 元素)加 [`aria-pressed`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-pressed) 属性来表示元素是否为切换按钮:
- 如果没有 `aria-pressed`,说明这不是一个切换按钮。
- 如果 `aria-pressed="false"`,说明这个按钮当前没有被按下。
From 3711271baa1a12a33b358b5ab0183c9a20a4cfa3 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 13:32:43 +0800
Subject: [PATCH 58/72] Update
files/zh-cn/web/accessibility/aria/roles/button_role/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index 89e0e1e7fcc59c..5589ae2705a984 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -80,7 +80,7 @@ button 角色会向辅助技术(如屏幕阅读器)识别一个元素为按
| Enter | 激活按钮。 |
| Space | 激活按钮。 |
-按钮激活后,会设置焦点,取决于按钮执行的操作的类型。比如,如果点击打开对话框的按钮,那么焦点应该移动到对话框。如果按钮是关闭对话框的,那么焦点应该回到打开对话框的按钮,除非对话框上下文中执行的功能在逻辑上是导向到不同的元素的。如果按钮更改了当前的上下文,例如将音频文件静音或者取消静音,那么焦点通常应该留在按钮上。
+按钮激活后,会根据按钮执行的操作的类型设置焦点。比如,如果点击打开对话框的按钮,那么焦点应该移动到对话框。如果按钮是关闭对话框的,那么焦点应该回到打开对话框的按钮,除非对话框上下文中执行的功能在逻辑上是导向到不同的元素的。如果按钮更改了当前的上下文,例如将音频文件静音或者取消静音,那么焦点通常应该留在按钮上。
### 必需的 JavaScript 功能
From db71bf7838877c73f056a9dcf8fd4f1397c45837 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 13:32:54 +0800
Subject: [PATCH 59/72] Update
files/zh-cn/web/accessibility/aria/roles/button_role/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index 5589ae2705a984..ebf76ec5e526c4 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -82,7 +82,7 @@ button 角色会向辅助技术(如屏幕阅读器)识别一个元素为按
按钮激活后,会根据按钮执行的操作的类型设置焦点。比如,如果点击打开对话框的按钮,那么焦点应该移动到对话框。如果按钮是关闭对话框的,那么焦点应该回到打开对话框的按钮,除非对话框上下文中执行的功能在逻辑上是导向到不同的元素的。如果按钮更改了当前的上下文,例如将音频文件静音或者取消静音,那么焦点通常应该留在按钮上。
-### 必需的 JavaScript 功能
+### 必需的 JavaScript 特性
#### 必需的事件处理器
From 16af3051192ec80fa34ac49e1de33efa072918e4 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 13:38:05 +0800
Subject: [PATCH 60/72] Update
files/zh-cn/web/accessibility/aria/roles/button_role/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index ebf76ec5e526c4..4347c04c44b4cb 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -265,7 +265,7 @@ function toggleButton(element) {
> **警告:** 谨慎将链接标记为按钮。按钮是预期使用 Space 或 Enter 键触发的,而链接是预期使用 Enter 触发的。也就是说,如果使用了链接以表现得像是个按钮,仅添加 `role="button"` 是不够的。还有必要为 Space 添加一个键事件处理器,以与原生的按钮行为保持一致。
-使用了 `button` 角色时,屏幕阅读器会将其说成是一个按钮,通常是说“单击(click)”然后是其可访问的名称。可访问名称是元素的内容,或者 `aria-label` 的会是,或者由 `aria-labelledby` 属性引用的值,或者描述(如果已包括)。
+使用了 `button` 角色时,屏幕阅读器会声明其说成是一个按钮,通常是说“单击(click)”然后是其无障碍名称。无障碍名称是元素的内容,或是 `aria-label` 的值,或是由 `aria-labelledby` 属性引用的元素的值,或是描述(如果已包括)。
## 最佳实践
From 89525cc053ef42a2a2a07ffdb4d65328f17a9a40 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 13:38:22 +0800
Subject: [PATCH 61/72] Update
files/zh-cn/web/accessibility/aria/roles/button_role/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index 4347c04c44b4cb..97f92dc442bad8 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -143,7 +143,7 @@ ul {
```js
function handleCommand(event) {
- // 处理鼠标单击以及 Enter 或 Space 的激活
+ // 处理鼠标单击以及 Enter 或 Space 的按键激活
// 除 Enter 或 Space 之外的按钮不应该触发命令
if (
From fa76564ec13d55fa3775f872d3f33f6a95ebf0b9 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 13:39:11 +0800
Subject: [PATCH 62/72] Update
files/zh-cn/web/accessibility/aria/roles/button_role/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index 97f92dc442bad8..88fba4d5e40527 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -286,7 +286,7 @@ function toggleButton(element) {
- [`aria-expanded`](https://www.w3.org/TR/wai-aria-1.1/#aria-expanded)
- [`aria-haspopup`](https://www.w3.org/TR/wai-aria-1.1/#aria-haspopup)
- [Strong native semantics in HTML5](https://html.spec.whatwg.org/multipage/dom.html#aria-usage-note)
-- [Notes on Using ARIA in HTML](https://www.w3.org/TR/aria-in-html/)
+- [在 HTML 中使用 ARIA 的注意事项](https://www.w3.org/TR/aria-in-html/)
- [Official WAI-ARIA example code](https://www.w3.org/TR/wai-aria-practices/examples/button/button.html)
From 97cf0439cb07cb5c7b6c0db1eace47059c08f12c Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 13:39:31 +0800
Subject: [PATCH 63/72] Update
files/zh-cn/web/accessibility/aria/roles/button_role/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index 88fba4d5e40527..4b8b6dddc63d9a 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -145,7 +145,7 @@ ul {
function handleCommand(event) {
// 处理鼠标单击以及 Enter 或 Space 的按键激活
- // 除 Enter 或 Space 之外的按钮不应该触发命令
+ // 除 Enter 或 Space 之外的按键不应该触发命令
if (
event instanceof KeyboardEvent &&
event.key !== "Enter" &&
From 2df5835722bacaa875bf66e649d62a20e741ea47 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 13:39:51 +0800
Subject: [PATCH 64/72] Update
files/zh-cn/web/accessibility/aria/roles/button_role/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index 4b8b6dddc63d9a..cd895c8bcbc3ff 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -176,7 +176,7 @@ function handleCommand(event) {
### 切换按钮示例
-在这个片段中,使用 `button` 角色和 `aria-pressed` 属性,来将 `` 元素转换为一个切换按钮,按钮被激活时,`aria-pressed` 的值在 `true` 和 `false` 之间切换。
+在这个片段中,使用 `button` 角色和 `aria-pressed` 属性,以将 {{HTMLElement("span")}} 元素转换为切换按钮,按钮被激活时,`aria-pressed` 的值在 `true` 和 `false` 之间切换。
#### HTML
From 808aab4020ffb377f9ede899200699e448743314 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 13:40:13 +0800
Subject: [PATCH 65/72] Update
files/zh-cn/web/accessibility/aria/roles/button_role/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index cd895c8bcbc3ff..7ca2a085474fb7 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -246,7 +246,7 @@ function toggleButton(element) {
// 将 aria-pressed 设为相反的状态
element.setAttribute("aria-pressed", !pressed);
- // 切换 audio 文件的 play 状态
+ // 切换音频文件的播放状态
if (pressed) {
audio.pause();
} else {
From 643bcd91476063138433c8f9ce042717048bc28a Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 13:40:41 +0800
Subject: [PATCH 66/72] Update
files/zh-cn/web/accessibility/aria/roles/button_role/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index 7ca2a085474fb7..359ff0066ca181 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -269,7 +269,7 @@ function toggleButton(element) {
## 最佳实践
-如果链接执行的是按钮的操作,那么给元素 `role="button"` 可以帮助辅助技术用户理解这个元素的功能。然后,更好的设计是调整视觉设计从而匹配其功能和 ARIA 角色。在有可能时,建议使用原生的 HTML 按钮(``、``、``、`` 和 ``)而不是 `button` 角色,因为能够被所有的用户代理和辅助技术都支持,且默认会提供键盘和焦点需求而不需要额外的自定义。
+如果链接执行的是按钮的操作,那么为元素设置 `role="button"` 可以帮助辅助技术用户理解这个元素的功能。然而,更好的设计是调整视觉设计从而匹配其功能和 ARIA 角色。如果可能,建议使用原生的 HTML 按钮(``、``、``、`` 和 ``)而不是 `button` 角色,因为原生 HTML 按钮能够被所有的用户代理和辅助技术所支持,且默认会提供键盘和聚焦需求而不需要额外的自定义。
## 规范
From 0db859dde61e60a0f3b841512137e656904e010e Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 13:40:52 +0800
Subject: [PATCH 67/72] Update
files/zh-cn/web/accessibility/aria/roles/button_role/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index 359ff0066ca181..e1990a1fb772bb 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -287,7 +287,7 @@ function toggleButton(element) {
- [`aria-haspopup`](https://www.w3.org/TR/wai-aria-1.1/#aria-haspopup)
- [Strong native semantics in HTML5](https://html.spec.whatwg.org/multipage/dom.html#aria-usage-note)
- [在 HTML 中使用 ARIA 的注意事项](https://www.w3.org/TR/aria-in-html/)
-- [Official WAI-ARIA example code](https://www.w3.org/TR/wai-aria-practices/examples/button/button.html)
+- [官方 WAI-ARIA 示例代码](https://www.w3.org/TR/wai-aria-practices/examples/button/button.html)
From 455b43207926733e4122f492d98a9905dc09e9cf Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 13:41:23 +0800
Subject: [PATCH 68/72] Update
files/zh-cn/web/accessibility/aria/roles/button_role/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index e1990a1fb772bb..5b54d0663efc9a 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -261,7 +261,7 @@ function toggleButton(element) {
## 无障碍考虑
-按钮本身是可交互的,因此可聚焦。如果给自身没有焦点的元素(如 ``、`` 或 `
`)添加了焦点,那么就应该使用 `tabindex` 属性以使得按钮可聚焦。
+按钮本身是可交互的,因此可聚焦。如果给自身不可聚焦的元素(如 ``、`` 或 `
`)添加了 `button` 角色,那么就应该使用 `tabindex` 属性以使得按钮可聚焦。
> **警告:** 谨慎将链接标记为按钮。按钮是预期使用 Space 或 Enter 键触发的,而链接是预期使用 Enter 触发的。也就是说,如果使用了链接以表现得像是个按钮,仅添加 `role="button"` 是不够的。还有必要为 Space 添加一个键事件处理器,以与原生的按钮行为保持一致。
From f7090cc390bcd0624905733beb39c960fc22cdc6 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 13:41:48 +0800
Subject: [PATCH 69/72] Update
files/zh-cn/web/accessibility/aria/roles/button_role/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index 5b54d0663efc9a..59db7227e92724 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -263,7 +263,7 @@ function toggleButton(element) {
按钮本身是可交互的,因此可聚焦。如果给自身不可聚焦的元素(如 ``、`` 或 `
`)添加了 `button` 角色,那么就应该使用 `tabindex` 属性以使得按钮可聚焦。
-> **警告:** 谨慎将链接标记为按钮。按钮是预期使用 Space 或 Enter 键触发的,而链接是预期使用 Enter 触发的。也就是说,如果使用了链接以表现得像是个按钮,仅添加 `role="button"` 是不够的。还有必要为 Space 添加一个键事件处理器,以与原生的按钮行为保持一致。
+> **警告:** 谨慎将链接标记为按钮。按钮是预期使用 Space 或 Enter 键触发的,而链接是预期使用 Enter 触发的。也就是说,如果将链接用作按钮,仅添加 `role="button"` 是不够的。还有必要为 Space 键添加一个按键事件处理器,以与原生按钮的行为保持一致。
使用了 `button` 角色时,屏幕阅读器会声明其说成是一个按钮,通常是说“单击(click)”然后是其无障碍名称。无障碍名称是元素的内容,或是 `aria-label` 的值,或是由 `aria-labelledby` 属性引用的元素的值,或是描述(如果已包括)。
From 316d7b1f8ca739b45c8cfd98a77ea61c7121b707 Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 13:43:36 +0800
Subject: [PATCH 70/72] Update index.md (roles/button_role)
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index 59db7227e92724..c424f21e5d9d00 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -285,7 +285,7 @@ function toggleButton(element) {
- [`aria-pressed`](https://www.w3.org/TR/wai-aria-1.1/#aria-pressed)
- [`aria-expanded`](https://www.w3.org/TR/wai-aria-1.1/#aria-expanded)
- [`aria-haspopup`](https://www.w3.org/TR/wai-aria-1.1/#aria-haspopup)
-- [Strong native semantics in HTML5](https://html.spec.whatwg.org/multipage/dom.html#aria-usage-note)
+- [HTML5 中强大的原生语义](https://html.spec.whatwg.org/multipage/dom.html#aria-usage-note)
- [在 HTML 中使用 ARIA 的注意事项](https://www.w3.org/TR/aria-in-html/)
- [官方 WAI-ARIA 示例代码](https://www.w3.org/TR/wai-aria-practices/examples/button/button.html)
From f89b0f7d235880851d69fc6b270a964b20c7a7ae Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 14:03:12 +0800
Subject: [PATCH 71/72] Update
files/zh-cn/web/accessibility/aria/roles/button_role/index.md
Co-authored-by: A1lo
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index c424f21e5d9d00..7dec62080173f1 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -86,7 +86,7 @@ button 角色会向辅助技术(如屏幕阅读器)识别一个元素为按
#### 必需的事件处理器
-按钮可能是由鼠标、触屏或者键盘用户操作的。对于原生的 `` 元素,按钮的 `onclick` 事件会在用户点击时,以及在按钮有焦点时用户按下 Space 或 Enter 时触发。但如果有其他的标签用于创建按钮,那么 `onclick` 事件只会有用户使用鼠标指针点击时才会触发,即使使用了 `role="button"`。因此,需要给元素添加单独的事件处理器,以在按下 Space 或 Enter 键时触发按钮。
+按钮可能是由鼠标、触屏或者键盘用户操作的。对于原生的 `` 元素,按钮的 `onclick` 事件会在用户点击时,以及在按钮被聚焦且用户按下 Space 或 Enter 时触发。但如果使用其他标签创建按钮,那么 `onclick` 事件只会在用户使用鼠标指针点击时才会触发,即使使用了 `role="button"`。因此,需要给元素添加单独的事件处理器,以在按下 Space 或 Enter 键时触发按钮。
- `onclick`
- : 使用鼠标点击或者触摸事件激活按钮时产生的事件。
From 7185f59afe389c17256031a08e986bb8c90af97a Mon Sep 17 00:00:00 2001
From: SolidBlock <32444848+SolidBlock-cn@users.noreply.github.com>
Date: Tue, 8 Aug 2023 14:04:32 +0800
Subject: [PATCH 72/72] Update index.md (aria/roles/button_role)
---
files/zh-cn/web/accessibility/aria/roles/button_role/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
index 7dec62080173f1..49d66cbfa426cb 100644
--- a/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
+++ b/files/zh-cn/web/accessibility/aria/roles/button_role/index.md
@@ -97,7 +97,7 @@ button 角色会向辅助技术(如屏幕阅读器)识别一个元素为按
### 基本按钮示例
-在这个例子中,span 元素有个 `button` 角色。由于使用了 `` 元素,需要使用 `tabindex` 属性以使得按钮可聚焦,并成为页面的 tab 顺序的一部分。还有包含 CSS 样式,以使用这个 `` 元素看上去像是个按钮,并在按钮有焦点时,提供了视觉呈现。
+在这个例子中,span 元素有个 `button` 角色。由于使用了 `` 元素,需要使用 `tabindex` 属性以使得按钮可聚焦,并成为页面的 tab 顺序的一部分。还有包含 CSS 样式,以使得这个 `` 元素看上去像是个按钮,并在按钮被聚焦时,提供了视觉呈现。
`handleBtnClick` 和 `handleBtnKeyDown` 事件处理器执行了按钮在鼠标单击或者按下 Space 或 Enter 键的操作。在这个例子中,操作是给名字列表添加一个新的名字。