表单控件必须有明确且持久的标签,使用绑定或嵌套;错误提示需具体、可定位、持续可见并正确关联;链接按钮文字须自解释;缩写首次出现时须用展开。

表单控件必须有明确且持久的标签
WCAG要求所有用户输入控件(如 <input>、<select></select>、<textarea></textarea>)都具备可编程关联的标签,不能仅靠视觉位置或占位符(placeholder)暗示含义。屏幕阅读器不会读取 placeholder 作为标签,且它在用户输入后即消失,破坏上下文连续性。
正确做法是始终使用 <label></label> 元素并绑定 for 属性与控件 id,或把控件嵌套在 <label></label> 内:
<label for="email">电子邮箱地址</label> <input type="email" id="email" name="email"> <label> 订单备注 <textarea name="notes"></textarea> </label>
- 避免仅用
aria-label或aria-labelledby替代原生<label></label>—— 它们不触发浏览器默认的点击聚焦行为,也不被所有辅助技术一致支持 - 禁用空
<label for="xxx"></label>:这会导致屏幕阅读器静默或报“无标签” - 多个控件共用同一语义意图时(如性别单选组),用
<fieldset></fieldset>+<legend></legend>包裹,而非重复写相同<label></label>
错误提示必须具体、可定位、持续可见
WCAG 3.3.1(错误识别)和 3.3.3(错误建议)要求:表单提交失败时,错误信息不能只靠颜色(如红字)传达,也不能仅出现在顶部全局提示栏里——用户无法快速定位到对应字段。
关键实操点:
立即学习“前端免费学习笔记(深入)”;
把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件(幻灯片风格)。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本,并且希望生成演示用的 HTML 时触发。支持任意内容来源:iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区,并通过企微直接发送给用户。触发词示例:帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。
- 每个出错字段旁紧邻放置错误消息,用
aria-invalid="true"标记该字段,并用aria-describedby指向错误元素id - 错误文本需说明“哪里错了”和“怎么改”,例如“手机号格式不正确(应为11位数字)”,而不是“请输入有效值”
- 不要依赖
title属性显示错误:它不被所有屏幕阅读器朗读,且悬停才出现,不符合键盘操作需求 - 校验应在用户离开字段(
blur)或提交时触发,避免输入中频繁中断(影响认知障碍用户)
链接和按钮文字必须自解释,不依赖上下文
WCAG 2.4.4(链接目的)规定:单独看一个链接或按钮文本,用户应能准确预判其结果。常见反例是“点击这里”“查看详情”“更多信息”——它们对屏幕阅读器用户毫无意义,尤其当多个同类链接并列时。
改进方式:
- 用动词+宾语结构,如
<a href="/report.pdf">下载2025年度无障碍合规报告(PDF, 2.1MB)</a> - 若视觉设计限制只能用简短文字,用
aria-label补充语义,但确保其内容不重复视觉文本(否则会被朗读两次) - 图标按钮必须配不可见但可读的文本,例如带搜索图标的按钮:
<button aria-label="搜索站点"><svg>...</svg></button> - 避免纯图像链接(
<a href="..."><img src="..." alt="HTML中如何满足WCAG的可理解原则" ></a>)未设alt:此时alt就是链接目的,必须描述动作而非图像内容
缩写、首字母缩略词必须首次出现时展开
WCAG 3.1.4(缩写)要求:所有缩写(如 WCAG、ARIA、PDF)在文档中第一次出现时,必须提供全称。这对认知障碍用户、非母语者和屏幕阅读器用户尤为重要——后者可能按字母逐个朗读缩写,造成理解断裂。
标准写法是使用 <abbr></abbr> 元素并设置 title 属性:
<p>本系统遵循<abbr title="Web Content Accessibility Guidelines">WCAG</abbr> 2.1 AA级标准。</p>
-
title值必须是完整、准确、无歧义的官方名称,不能是解释性描述(如“一套网页无障碍规范”) - 不要滥用
<abbr></abbr>:常见缩写如 “HTML”、“URL”、“PDF” 可视项目受众决定是否展开;但专业术语如 “ATAG”、“UAAG” 必须展开 - JavaScript 动态插入的缩写内容,也要同步注入
<abbr></abbr>结构,否则初始 DOM 中缺失,屏幕阅读器无法捕获


















