在为屏幕阅读器设计带有动态文本的按钮时，直接使用 `aria-label` 会覆盖按钮的可见文本，导致动态值无法被朗读。本文将探讨一种更佳的无障碍实践，即通过将动态值与按钮行为分离，并利用 `aria-describedby` 属性，确保按钮的动作意图和其关联的动态状态都能被屏幕阅读器用户准确理解。
理解按钮的语义角色
在Web无障碍设计中，按钮（button）元素的核心作用是触发一个动作。它应该清晰地传达其功能，例如“提交”、“取消”、“更改设置”等。当按钮的文本需要根据应用程序状态动态变化时（例如显示当前选定的值），我们面临一个挑战：如何既能为屏幕阅读器提供明确的动作标签，又能传达其当前关联的动态值？
一个常见的误区是尝试将动态值直接嵌入到按钮的 aria-label 中。例如，如果一个按钮用于选择时间段，并且其文本显示当前选定的“3天”，如果直接设置 aria-label="3天" 或 aria-label="选择时间段：3天"，屏幕阅读器将只朗读 aria-label 的内容，而忽略按钮内部的可见文本，这可能导致信息冗余或不准确。更严重的是，如果 aria-label 仅包含动态值（如“3天”），则按钮的动作意图（“更改时间段”）就丢失了。
推荐的无障碍实践：分离值与动作
最佳实践是将按钮的动作意图与其当前关联的动态值进行分离。按钮应专注于其动作描述，而动态值则应作为独立的DOM元素存在，并通过无障碍属性与按钮建立关联。这样，屏幕阅读器用户可以清晰地理解按钮的功能，同时也能获取其当前状态的上下文信息。
核心思路：
- 按钮的文本或 aria-label 应明确描述其将要执行的动作。
- 动态值应放置在一个单独的、具有语义的DOM元素中（例如 p、span 等）。
- 使用 aria-describedby 属性将按钮与包含动态值的元素关联起来。
使用 aria-describedby 关联动态值
aria-describedby 属性用于指定一个或多个元素，这些元素包含了对当前元素的描述信息。当屏幕阅读器聚焦到带有 aria-describedby 的元素时，它会先朗读元素的名称/标签，然后朗读其描述。这正是我们解决动态值问题的理想方案。
示例代码：
假设我们有一个按钮，用于更改时间段，并且页面上某个位置显示了当前选定的时间段（例如“3天”）。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
<p id="current-time-period">当前时间段：3天</p> <button aria-describedby="current-time-period">更改时间段</button>
代码解释：
-
当前时间段：3天
：这是一个普通的段落元素，其 id 为 current-time-period，用于承载动态显示的时间段值。当时间段改变时，只需要更新这个 p 标签的文本内容即可。 - ：这是一个标准的按钮，其可见文本是“更改时间段”，清晰地表达了按钮的功能。aria-describedby="current-time-period" 属性将此按钮与上述 p 元素关联起来。
屏幕阅读器体验：
当屏幕阅读器用户通过Tab键导航到这个按钮时，他们将听到类似这样的朗读：
"更改时间段，按钮，当前时间段：3天"
这样，用户不仅知道这是一个“更改时间段”的按钮，还立即获得了关于当前时间段的上下文信息。
注意事项与总结
- aria-describedby 的作用是提供描述：它为用户提供了关于元素的额外信息或上下文，而不是元素的名称或标签。元素的名称（通过其文本内容、aria-label 或 aria-labelledby 提供）应始终清晰地表达其主要功能。
- 用户设置的影响：需要注意的是，某些屏幕阅读器允许用户关闭“描述”或“提示”信息的朗读。在这种情况下，用户可能不会听到 aria-describedby 提供的内容。然而，这通常是用户偏好设置，开发者无法强制覆盖。用户仍然可以通过其他屏幕阅读器快捷键导航到相关的文本元素来获取信息。
- 避免滥用 aria-label：如果按钮的可见文本已经足够描述其功能，则无需使用 aria-label。只有当可见文本不足以清晰表达功能时，才应考虑使用 aria-label 或 aria-labelledby 提供更准确的标签。
- 语义化HTML：始终优先使用语义化的HTML元素。只有当没有合适的HTML语义时，才考虑使用ARIA属性来增强无障碍性。
通过遵循这种分离动态值与按钮动作的策略，并合理运用 aria-describedby，我们可以为屏幕阅读器用户提供更清晰、更全面的交互体验，从而显著提升Web应用的无障碍性。
