From b6857fdc1e9bfedc07a69462b3cf2fdcb2a5ebd6 Mon Sep 17 00:00:00 2001 From: Tianyi Tao <146603607+tianyeeT@users.noreply.github.com> Date: Tue, 28 May 2024 22:35:35 +0800 Subject: [PATCH 1/4] [zh-cn]: create the translation of `aria-atomic` --- .../aria/attributes/aria-atomic/index.md | 37 +++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 files/zh-cn/web/accessibility/aria/attributes/aria-atomic/index.md diff --git a/files/zh-cn/web/accessibility/aria/attributes/aria-atomic/index.md b/files/zh-cn/web/accessibility/aria/attributes/aria-atomic/index.md new file mode 100644 index 00000000000000..f7fe8e746e89f9 --- /dev/null +++ b/files/zh-cn/web/accessibility/aria/attributes/aria-atomic/index.md @@ -0,0 +1,37 @@ +--- +title: aria-atomic +slug: Web/Accessibility/ARIA/Attributes/aria-atomic +l10n: + sourceCommit: 019ca5c9ce641bfa02825e1ba0444f35dfb646cc +--- + +{{AccessibilitySidebar}} + +在 ARIA 活动区域中，全局 `aria-atomic` 属性指示辅助技术（如屏幕阅读器）是否基于由 [`aria-relevant`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-relevant) 属性定义的更改通知，呈现所有或仅部分更改区域。 + +## 描述 + +活动区域是网页的部分，在用户焦点在其他地方时更新，无论是通过用户交互还是其他方式。由于它们在用户焦点之外更新，因此辅助技术（如屏幕阅读器）可能无法“看到”更新并将其报告给用户。WAI-ARIA 有 4 个属性，允许开发人员识别这些活动区域并告诉辅助技术如何处理它们，包括 [`aria-live`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-live)、[`aria-relevant`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-relevant)、[`aria-busy`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-busy) 和 `aria-atomic`。 + +当活动区域的内容发生更改时，DOM 从更改的元素经过其祖先以找到首个设置了 `aria-atomic` 的元素。这确定了应该向用户呈现的内容。 + +如果没有祖先明确设置了 `aria-atomic`，则仅读取已更新的活动区域内容的节点或节点。省略 `aria-atomic` 和显式设置 ARIA 活动区域的祖先节点的差异在于，显式设置 `aria-atomic="false"` 会阻止屏幕阅读器上溯祖先链。两者都导致仅读取更新的节点。当设置为 `aria-atomic="true"` 时，将呈现整个更改的区域，包括更新的节点的 `label` （如果存在）。 + +## 值 + +- `false`（默认） + - : 仅呈现更改的节点或节点。 +- `true` + - : 呈现整个更改的区域，包括作者定义的标签（如果存在）。 + +## 关联角色 + +适用于**所有**[角色](/zh-CN/docs/Web/Accessibility/ARIA/Roles)。 + +## 规范 + +{{Specifications}} + +## 参见 + +- [Event.ariaAtomic](/zh-CN/docs/Web/API/Element/ariaAtomic) From 2182cedb1f16e4687915992f6608487c6c765f4a Mon Sep 17 00:00:00 2001 From: Tianyi Tao <146603607+tianyeeT@users.noreply.github.com> Date: Tue, 28 May 2024 22:54:41 +0800 Subject: [PATCH 2/4] Update files/zh-cn/web/accessibility/aria/attributes/aria-atomic/index.md Co-authored-by: A1lo --- .../web/accessibility/aria/attributes/aria-atomic/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/zh-cn/web/accessibility/aria/attributes/aria-atomic/index.md b/files/zh-cn/web/accessibility/aria/attributes/aria-atomic/index.md index f7fe8e746e89f9..0a5f4f54aa0152 100644 --- a/files/zh-cn/web/accessibility/aria/attributes/aria-atomic/index.md +++ b/files/zh-cn/web/accessibility/aria/attributes/aria-atomic/index.md @@ -15,7 +15,7 @@ l10n: 当活动区域的内容发生更改时，DOM 从更改的元素经过其祖先以找到首个设置了 `aria-atomic` 的元素。这确定了应该向用户呈现的内容。 -如果没有祖先明确设置了 `aria-atomic`，则仅读取已更新的活动区域内容的节点或节点。省略 `aria-atomic` 和显式设置 ARIA 活动区域的祖先节点的差异在于，显式设置 `aria-atomic="false"` 会阻止屏幕阅读器上溯祖先链。两者都导致仅读取更新的节点。当设置为 `aria-atomic="true"` 时，将呈现整个更改的区域，包括更新的节点的 `label` （如果存在）。 +如果没有祖先明确设置了 `aria-atomic`，则仅读取已更新的活动区域内容的节点或节点。省略 `aria-atomic` 和显式设置 ARIA 活动区域的祖先节点的差异在于，显式设置 `aria-atomic="false"` 会阻止屏幕阅读器上溯祖先链。两者都导致仅读取更新的节点。当设置为 `aria-atomic="true"` 时，将呈现整个更改的区域，包括更新的节点的 `label`（如果存在）。 ## 值 From 613be2c71cdc047d262fc369aa76caf1e544304b Mon Sep 17 00:00:00 2001 From: Tianyi Tao Date: Tue, 18 Jun 2024 21:16:57 +0800 Subject: [PATCH 3/4] Update files/zh-cn/web/accessibility/aria/attributes/aria-atomic/index.md Co-authored-by: Jason Ren <40999116+jasonren0403@users.noreply.github.com> --- .../web/accessibility/aria/attributes/aria-atomic/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/zh-cn/web/accessibility/aria/attributes/aria-atomic/index.md b/files/zh-cn/web/accessibility/aria/attributes/aria-atomic/index.md index 0a5f4f54aa0152..45f07ee9552556 100644 --- a/files/zh-cn/web/accessibility/aria/attributes/aria-atomic/index.md +++ b/files/zh-cn/web/accessibility/aria/attributes/aria-atomic/index.md @@ -7,7 +7,7 @@ l10n: {{AccessibilitySidebar}} -在 ARIA 活动区域中，全局 `aria-atomic` 属性指示辅助技术（如屏幕阅读器）是否基于由 [`aria-relevant`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-relevant) 属性定义的更改通知，呈现所有或仅部分更改区域。 +在 ARIA 实时区域中，`aria-atomic` 全局属性指示辅助技术（如屏幕阅读器）是否基于由 [`aria-relevant`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-relevant) 属性定义的更改通知，呈现所有或仅部分更改区域。 ## 描述 From 604b686aa230fd84d62d7370096f2764ee878d6d Mon Sep 17 00:00:00 2001 From: Tianyi Tao Date: Wed, 19 Jun 2024 12:45:44 +0800 Subject: [PATCH 4/4] Apply suggestions from code review --- .../web/accessibility/aria/attributes/aria-atomic/index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/files/zh-cn/web/accessibility/aria/attributes/aria-atomic/index.md b/files/zh-cn/web/accessibility/aria/attributes/aria-atomic/index.md index 45f07ee9552556..53986e928e8e17 100644 --- a/files/zh-cn/web/accessibility/aria/attributes/aria-atomic/index.md +++ b/files/zh-cn/web/accessibility/aria/attributes/aria-atomic/index.md @@ -11,11 +11,11 @@ l10n: ## 描述 -活动区域是网页的部分，在用户焦点在其他地方时更新，无论是通过用户交互还是其他方式。由于它们在用户焦点之外更新，因此辅助技术（如屏幕阅读器）可能无法“看到”更新并将其报告给用户。WAI-ARIA 有 4 个属性，允许开发人员识别这些活动区域并告诉辅助技术如何处理它们，包括 [`aria-live`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-live)、[`aria-relevant`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-relevant)、[`aria-busy`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-busy) 和 `aria-atomic`。 +实时区域是网页的部分，在用户焦点在其他地方时更新，无论是通过用户交互还是其他方式。由于它们在用户焦点之外更新，因此辅助技术（如屏幕阅读器）可能无法“看到”更新并将其报告给用户。WAI-ARIA 有 4 个属性，允许开发人员识别这些实时区域并告诉辅助技术如何处理它们，包括 [`aria-live`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-live)、[`aria-relevant`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-relevant)、[`aria-busy`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-busy) 和 `aria-atomic`。 -当活动区域的内容发生更改时，DOM 从更改的元素经过其祖先以找到首个设置了 `aria-atomic` 的元素。这确定了应该向用户呈现的内容。 +当实时区域的内容发生更改时，DOM 从更改的元素经过其祖先以找到首个设置了 `aria-atomic` 的元素。这确定了应该向用户呈现的内容。 -如果没有祖先明确设置了 `aria-atomic`，则仅读取已更新的活动区域内容的节点或节点。省略 `aria-atomic` 和显式设置 ARIA 活动区域的祖先节点的差异在于，显式设置 `aria-atomic="false"` 会阻止屏幕阅读器上溯祖先链。两者都导致仅读取更新的节点。当设置为 `aria-atomic="true"` 时，将呈现整个更改的区域，包括更新的节点的 `label`（如果存在）。 +如果没有祖先明确设置了 `aria-atomic`，则仅读取已更新的实时区域内容的节点或节点。省略 `aria-atomic` 和显式设置 ARIA 实时区域的祖先节点的差异在于，显式设置 `aria-atomic="false"` 会阻止屏幕阅读器上溯祖先链。两者都导致仅读取更新的节点。当设置为 `aria-atomic="true"` 时，将呈现整个更改的区域，包括更新的节点的 `label`（如果存在）。 ## 值