正确使用 aria-describedby 关联表单错误提示需确保错误元素有唯一稳定 ID、输入框 aria-describedby 值准确引用该 ID，并配合 aria-live="polite" 和 aria-invalid="true" 实现动态可访问反馈。
用 aria-describedby 关联表单错误提示，核心是让屏幕阅读器在聚焦输入框时自动读出错误信息，同时确保 DOM 中的 ID 引用准确、语义清晰、时机恰当。
确保错误提示元素有稳定且唯一的 ID
错误提示必须是一个独立的 HTML 元素（如 <div>、<code><p></p> 或 <span></span>），并设置明确的 id 属性。这个 ID 不能重复，也不应动态生成后丢失（比如 Vue/React 中未正确保留或条件渲染导致元素不存在）。
- ✅ 推荐写法：
<p id="email-error" class="error-text" aria-live="polite">请输入有效的邮箱地址</p> - ❌ 避免写法：
<span>请输入有效的邮箱地址</span>（无 ID，无法被引用） - ⚠️ 注意：如果错误提示是 JS 动态插入的，插入后必须保证该元素已挂载到 DOM 且 ID 可查
在输入框上正确设置 aria-describedby 指向该 ID
将输入框的 aria-describedby 属性值设为错误提示元素的 id。可同时关联多个 ID（用空格分隔），例如补充说明或格式提示。
Wechat Article Html
下载
将 Markdown 文章转换为微信公众号兼容的纯 HTML 格式。当用户要求"转成微信格式"、"生成公众号文章 HTML"、"排版到微信草稿箱"、"微信粘贴格式"时触发。输出带内联样式的纯 HTML，微信编辑器可直接渲染，无需额外适配。支持标题、段落、列表、粗体、行内代码、表格、引用块、代码块、配图的完整转换。
- ✅ 示例：
<input type="email" aria-describedby="email-error"> - ✅ 多个关联：
<input type="password" aria-describedby="pw-hint pw-error"> - ⚠️ 注意：不要把提示文字直接写进
aria-describedby（如aria-describedby="请输入有效邮箱"），它只接受 ID 引用
配合 aria-live 和视觉状态提升可访问性体验
aria-describedby 本身只在获得焦点时播报一次。若错误是提交后动态显示的，需额外用 aria-live 让屏幕阅读器主动感知变化。
- 给错误提示容器添加
aria-live="polite"，确保内容更新时能被朗读 - 错误出现时，确保输入框拥有
aria-invalid="true"，强化语义 - 视觉上建议同步添加红框、图标、高对比色等，形成多通道反馈
- 避免仅靠颜色传达错误（如单用红色文字），需搭配图标或文字说明
验证是否生效的简单方法
不用依赖工具也能快速检查：开启系统自带的屏幕阅读器（如 macOS VoiceOver 或 Windows NVDA），聚焦输入框，听是否播报错误文本；同时检查浏览器开发者工具中，aria-describedby 的值是否与目标元素 ID 完全一致（包括大小写和连字符）。
- ✅ 正确匹配示例：
aria-describedby="user-name-error"↔<span id="user-name-error">...</span> - ❌ 常见失败原因：ID 拼错、元素被
display: none或visibility: hidden隐藏（屏幕阅读器可能跳过）、JS 插入延迟导致初始无该节点
不复杂但容易忽略的是：ID 必须存在、必须可见、必须可访问。只要这三点到位，aria-describedby 就能自然、可靠地把错误信息送到用户耳中。
