Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

[zh-cn]: update the translation of the list role #20926

Merged
merged 2 commits into from
Jun 15, 2024
Merged

[zh-cn]: update the translation of the list role #20926

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
963fcf4
[zh-cn]: update the translation of `roles/list_role`
tianyeeT May 28, 2024
94cef16
Apply suggestions from code review
yin1999 Jun 15, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 7 additions & 5 deletions files/zh-cn/web/accessibility/aria/roles/list_role/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
---
title: ARIA：list 角色
slug: Web/Accessibility/ARIA/Roles/list_role
l10n:
sourceCommit: 019ca5c9ce641bfa02825e1ba0444f35dfb646cc
---

{{AccessibilitySidebar}}
Expand All @@ -21,13 +23,13 @@ ARIA `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 角色、状态和属性

- [listitem](/zh-CN/docs/Web/Accessibility/ARIA/Roles/Listitem_role)
- [`listitem`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/listitem_role) 角色
- : 列表或目录中的单个项目。角色为 listitem 的元素只能在角色为 `list` 或 `group` 的元素中找到。
- [group](/zh-CN/docs/Web/Accessibility/ARIA/Roles/group_role)
- [`group`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/group_role) 角色
- : 相关对象的集合，在嵌套在列表中时仅限于列表项，其重要性不足以在页面目录中拥有自己的位置。

## 最佳实践
Expand Down Expand Up @@ -56,9 +58,9 @@ ARIA `list` 角色可用于标识项目列表。它通常与 `listitem` 角色

> **备注：** ARIA `list` / `listitem` 角色不区分有序列表和无序列表。

顺便说一句，请注意，如果你使用 {{HTMLElement("ol")}} 或 {{HTMLElement("ul")}} 的语义 HTML 元素并应用 [`presentation`](/zh-CN/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_presentation_role) 角色，则每个子 `li` 元素都会继承 `presentation` 角色，因为 ARIA 需要 `listitem` 元素具有父 `list` 元素。因此，`li` 元素不会暴露给辅助技术，但是包含在这些 `li` 元素中的元素，包括嵌套列表，对辅助技术是可见的。
顺便说一句，请注意，如果你使用 `<ol>` 或 `<ul>` 的语义 HTML 元素并应用 [`presentation`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/presentation_role) 角色，则每个子 `<li>` 元素都会继承 `presentation` 角色，因为 ARIA 需要 `listitem` 元素具有父 `list` 元素。因此，`<li>` 元素不会暴露给辅助技术，但是包含在这些 `<li>` 元素中的元素，包括嵌套列表，对辅助技术是可见的。

> **备注：** 如果要标记将用作选项卡式界面的项目列表，则应改为使用 `tab`、`tabpanel` 和 `tablist` 角色。
> **备注：** 如果要标记将用作标签页式界面的项目列表，则应改为使用 [`tab`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/tab_role)、[`tabpanel`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/tabpanel_role) 和 [`tablist`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/tablist_role) 角色。

## 规范

Expand Down