同一个 SVG,可能是必须被读出来的关键信息,也可能只是装饰。区别不在图形本身,而在于你有没有明确告诉辅助技术该怎么对待它。
01装饰还是信息
纯装饰图标应设置 aria-hidden="true" 并去掉 focusable,避免在读屏时插入无意义的「图像」;承载信息的图标则需要可访问名称,可用 <title> 配合 role="img" 与 aria-labelledby,或在外部用 aria-label 说明。图标按钮的名称应描述动作而不是外观:「搜索」比「放大镜」更准确。
最后提醒一句:围绕「SVG 图标」形成的约定应当尽量少而稳定。规则越多越难被遵守,把最关键的几条固化到组件和模板里,让默认路径就是正确路径,比依赖每个人记得查清单更可靠。
02内联与外部文件
内联 SVG 便于用 currentColor 继承文字颜色、参与主题切换,也便于控制语义属性;作为 <img> 引用时用 alt 提供等效文本,纯装饰用空 alt;<use> 引用 symbol 时要注意 <title> 的作用域与浏览器差异。避免把关键文字做成路径或背景图,那样既不随字号缩放,也不会进入可访问性树。
最后提醒一句:围绕「SVG 图标」形成的约定应当尽量少而稳定。规则越多越难被遵守,把最关键的几条固化到组件和模板里,让默认路径就是正确路径,比依赖每个人记得查清单更可靠。
03颜色、尺寸与状态
图形对比度需满足 1.4.11 的 3:1 要求(对理解内容必要的图形);不要把颜色作为唯一区分,图标切换状态时同步更新名称与 aria-pressed / aria-current。触控场景下保证所在按钮的热区不小于 24×24,并在 forced-colors 模式下检查图标是否仍可见——用 currentColor 通常比硬编码 fill 更稳妥。
最后提醒一句:围绕「SVG 图标」形成的约定应当尽量少而稳定。规则越多越难被遵守,把最关键的几条固化到组件和模板里,让默认路径就是正确路径,比依赖每个人记得查清单更可靠。
要点速览
- 装饰图标 aria-hidden="true",信息图标给可访问名称
- 图标按钮名称描述动作,而非图形外观
- 内联 SVG 用 currentColor 便于主题与强制颜色适配
- 关键图形对比度 3:1,状态变化同步更新语义属性
图标的第一属性不是好看,是被正确理解。
