[zh-cn]: create the translation of aria-description attribute
#23730
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
|
Preview URLs Flaws (2)URL:
(comment last updated: 2024-09-22 10:55:21) |
tianyeeT
commented
Sep 22, 2024
files/zh-cn/web/accessibility/aria/attributes/aria-description/index.md
Outdated
Show resolved
Hide resolved
yin1999
reviewed
Sep 24, 2024
|
|
||
| {{AccessibilitySidebar}} | ||
|
|
||
| 全局 `aria-description` 属性定义了一个字符串值，用于描述或注解当前元素。 |
There was a problem hiding this comment.
Suggested change
| 全局 `aria-description` 属性定义了一个字符串值，用于描述或注解当前元素。 | |
| 全局 `aria-description` 属性定义了一个用于描述或注解当前元素的字符串值。 |
|
|
||
| 全局 `aria-description` 属性定义了一个字符串值，用于描述或注解当前元素。 | ||
|
|
||
| > **备注：** `aria-description` 仍处于 W3C ARIA 1.3 编辑草案中。暂时请继续使用 [`aria-describedby`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-describedby)，自 ARIA 1.1 起已获得支持。 |
There was a problem hiding this comment.
Suggested change
| > **备注：** `aria-description` 仍处于 W3C ARIA 1.3 编辑草案中。暂时请继续使用 [`aria-describedby`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-describedby)，自 ARIA 1.1 起已获得支持。 | |
| > **备注：** `aria-description` 仍处于 W3C ARIA 1.3 编辑草案中。暂时请继续使用自 ARIA 1.1 起就已获得支持的 [`aria-describedby`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-describedby)。 |
|
|
||
| ## 描述 | ||
|
|
||
| 全局 `aria-description` 属性为开发者提供了一种机制，用于描述或注解当前元素，为辅助技术用户提供更大的上下文。 |
There was a problem hiding this comment.
Suggested change
| 全局 `aria-description` 属性为开发者提供了一种机制，用于描述或注解当前元素，为辅助技术用户提供更大的上下文。 | |
| 全局 `aria-description` 属性为开发者提供了一种为当前元素添加描述或注解的机制，为辅助技术用户提供更大的上下文。 |
|
|
||
| `aria-description` 和 `aria-describedby` 属性的目的相同；两者都为设置的对象提供额外的描述性文本。如果在 DOM 中有描述性文本，请改用 [`aria-describedby`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-describedby)。 | ||
|
|
||
| 只有在不希望提供可见描述的用户体验时，才应使用 `aria-description` 属性。`aria-describedby` 属性的值为包含关于对象的描述性文本的元素的 `id` 列表。当没有适当的描述性文本可以通过 `id` 引用与对象关联时，使用 `aria-description`。如果同时存在这两个属性，则 `aria-describedby` 在定义 {{glossary("accessible description")}} 属性时具有优先权。 |
There was a problem hiding this comment.
Suggested change
| 只有在不希望提供可见描述的用户体验时，才应使用 `aria-description` 属性。`aria-describedby` 属性的值为包含关于对象的描述性文本的元素的 `id` 列表。当没有适当的描述性文本可以通过 `id` 引用与对象关联时，使用 `aria-description`。如果同时存在这两个属性，则 `aria-describedby` 在定义 {{glossary("accessible description")}} 属性时具有优先权。 | |
| 只有在提供可见描述无法带来期望的用户体验时，才应使用 `aria-description` 属性。`aria-describedby` 属性的值为包含关于对象的描述性文本的元素的 `id` 列表。当没有适当的描述性文本可以通过 `id` 引用与对象关联时，使用 `aria-description`。如果同时存在这两个属性，则 `aria-describedby` 优先定义{{glossary("accessible description", "无障碍描述")}}属性。 |
|
|
||
| 只有在不希望提供可见描述的用户体验时，才应使用 `aria-description` 属性。`aria-describedby` 属性的值为包含关于对象的描述性文本的元素的 `id` 列表。当没有适当的描述性文本可以通过 `id` 引用与对象关联时，使用 `aria-description`。如果同时存在这两个属性，则 `aria-describedby` 在定义 {{glossary("accessible description")}} 属性时具有优先权。 | ||
|
|
||
| 无论是通过 `aria-description` 还是 `aria-describedby` 设置的描述内容，应为纯文本。如果内容非常长、具有语义要求或具有导航结构，请使用 [`aria-details`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-details)。 |
There was a problem hiding this comment.
Suggested change
| 无论是通过 `aria-description` 还是 `aria-describedby` 设置的描述内容，应为纯文本。如果内容非常长、具有语义要求或具有导航结构，请使用 [`aria-details`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-details)。 | |
| 无论是通过 `aria-description` 还是 `aria-describedby` 设置，描述内容都应为纯文本。如果内容非常长、具有语义要求或具有导航结构，请改用 [`aria-details`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-details)。 |
| ## 相关接口 | ||
|
|
||
| - {{domxref("Element.ariaDescription")}} | ||
| - : [`ariaDescription`](/zh-CN/docs/Web/API/Element/ariaDescription) 属性，作为 {{domxref("Element")}} 接口的一部分，反映了 `aria-description` 属性的值，该值定义了描述或注解当前元素的字符串值。 |
There was a problem hiding this comment.
Suggested change
| - : [`ariaDescription`](/zh-CN/docs/Web/API/Element/ariaDescription) 属性，作为 {{domxref("Element")}} 接口的一部分，反映了 `aria-description` 属性的值，该值定义了描述或注解当前元素的字符串值。 | |
| - : {{domxref("Element")}} 接口的 [`ariaDescription`](/zh-CN/docs/Web/API/Element/ariaDescription) 属性反映了 HTML 属性 `aria-description` 的值，该值定义了描述或注解当前元素的字符串值。 |
|
|
||
| ## 相关角色 | ||
|
|
||
| 在**所有**角色中使用。 |
There was a problem hiding this comment.
Suggested change
| 在**所有**角色中使用。 | |
| 可在**所有**角色中使用。 |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Description
Motivation
Additional details
Related issues and pull requests
part of #20821