aria-describedby 用于关联说明文字与表单控件,提升可访问性;需用唯一、语义化 ID 引用独立 HTML 元素,支持多 ID 空格分隔,不可替代 label,内容须简洁明确,并通过屏幕阅读器真实测试验证。

用 aria-describedby 可以把一段说明文字和表单控件关联起来,让屏幕阅读器在读取控件时自动朗读说明,特别适合解释格式要求、限制条件或业务规则等复杂内容。
确保说明文字有唯一 ID
被引用的说明文本必须是一个独立的 HTML 元素(如 将控件的 屏幕阅读器会逐字朗读 仅写对代码不等于体验到位,真实环境验证很关键。 或 ),且带有明确的 id。这个 id 将作为 aria-describedby 的值。
id,否则屏幕阅读器可能只读第一个或行为不可预测email-hint 比 hint1 更易维护在表单控件上设置 aria-describedby
aria-describedby 属性值设为说明元素的 id。支持多个 ID,用空格分隔,适用于同时需要提示 + 错误消息 + 格式示例的场景。
aria-describedby 替代 label —— 它补充说明,不替代标签的必选语义让说明内容本身更友好
aria-describedby 所指向的内容,所以文字需简洁、具体、无歧义。
role="link"、tabindex="0"、键盘可用)测试与常见误区
aria-describedby——超过 2–3 句可能信息过载,可拆成多个 ID 分别引用aria-invalid 和 aria-errormessage 管理,保持职责分离










