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.

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

[zh-cn]: create the translation of aria-activedescendent #20931

Merged
merged 3 commits into from
Jun 16, 2024
Merged
Changes from all commits
Commits
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
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
---
title: aria-activedescendant
slug: Web/Accessibility/ARIA/Attributes/aria-activedescendant
l10n:
sourceCommit: 019ca5c9ce641bfa02825e1ba0444f35dfb646cc
---

{{AccessibilitySidebar}}

`aria-activedescendant` 属性用于标识焦点位于 [`composite`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/composite_role) 微件、[`combobox`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/combobox_role)、[`textbox`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/textbox_role)、[`group`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/group_role)或 [`application`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/application_role) 上时当前活动的元素。

## 描述

`aria-activedescendant` 属性为辅助技术提供了一种在交互元素包含多个可聚焦后代时(例如菜单、网格和工具栏),进行焦点管理的方法。与屏幕阅读器在拥有的元素之间移动焦点不同,`aria-activedescendant` 可以在容器元素上使用,引用当前活动的元素,用于在聚焦时向辅助技术用户指示当前活动的元素。

使用 `aria-activedescendant`,浏览器会将 DOM 焦点保持在容器元素或控制容器元素的输入元素上。但是,用户代理将桌面聚焦事件和状态发送给辅助技术,就好像 `aria-activedescendant` 引用的元素具有焦点一样。

此属性仅适用于具有 [`composite`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/composite_role) 微件、[`combobox`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/combobox_role)、[`textbox`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/textbox_role)、[`group`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/group_role) 或 [`application`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/application_role) 角色的元素,其 `id` 被引用为属性值。

该属性用于为辅助技术提供有关焦点位于哪个元素的信息,但实际上不会创建焦点。使用 JavaScript 来更改焦点并管理属性值。除了管理该属性值之外,确保当前活动的后代在聚焦时可见并在视野内(或滚动到视野内)。

在具有 DOM 焦点的元素上设置 `aria-activedescendant` 的值时,确保该值引用所拥有的元素——即 DOM 焦点元素的后代或由 [`aria-owns`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-owns) 属性指示的逻辑后代。

当具有 DOM 焦点的元素是组合框、文本框或搜索框时,请包括 [`aria-controls`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-controls) 以引用支持 `aria-activedescendant` 的元素。

`aria-activedescendant` 的值引用受控元素所拥有的元素。例如,在组合框中,焦点可能仍然位于组合框上,但组合框元素上的 `aria-activedescendant` 的值引用由组合框控制的弹出列表框的后代。

> **备注:** 该属性仅支持少数角色。例如,`dialog` 不支持 `aria-activedescendant`。当组合框打开对话框时,DOM 焦点从组合框移动到对话框,因为它不能通过此属性进行引用。

> **备注:** 当焦点位于 `listbox`、`grid` 或 `tree` 弹出窗口的后代时,DOM 焦点保持在组合框上,并且组合框的 `aria-activedescendant` 设置为引用弹出窗口内的焦点元素的值。

## 值

- ID 引用
- : 其值为当前具有焦点元素的 `id`。

## 关联角色

仅适用于具有以下角色的元素的属性:

- [`application`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/application_role)
- [`combobox`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/combobox_role)
- [`composite`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/composite_role)
- [`group`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/group_role)
- [`textbox`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/textbox_role)

## 规范

{{Specifications}}