WordPress图片的alt要按它在当前页面中的用途写:信息图说明读者需要知道的内容,只有图片的链接说明目的地或动作,纯装饰图通常保留alt=""。空alt与缺少alt属性不是一回事,也不是每张图都要填上一句话。先判断图片承担什么任务,再核已发布页面的实际输出;不要把“媒体库填满了”当成全部改好。
先看这次使用,而不是只看媒体库里的文件
同一张产品图可以出现在产品详情、分类卡片和文章装饰位置。它在每处传达的信息与承担的操作不同,alt不一定相同。W3C WAI的alt决策树先问图片是否有文字、是否承担链接或按钮功能,再判断是否提供信息;没有给所有图片一套通用句式。
| 页面里的用途 | 怎样处理 | 别漏了什么 |
|---|---|---|
| 说明产品外观或操作位置 | 写出当前任务需要的信息 | 别从照片猜材质、规格或认证;型号只在已核实且有用时写 |
| 纯装饰,或已有完整文字替代且无额外功能 | 保留alt属性,值为空 | 不能只因旁边有一段文字就认定图片毫无信息 |
| 链接或按钮里只有图片 | 让控件名称说明目的地或动作 | “蓝色箭头”“产品图”通常没有说清点击后会发生什么 |
| 同一个链接内已有充分文字,图片没有补充信息 | 图片可用空alt,由链接文字承担名称 | 链接外的标题不自动成为这个链接的名称 |
| 图表、接线图或复杂流程 | 简短识别图片,并提供可找到的完整文字说明 | 单位、步骤、关系和必要数据不能只藏在图里 |
表格是判断入口,不替代逐图阅读。WAI装饰图说明明确区分空alt和缺属性:省略属性可能让部分屏幕阅读器读出文件名,增加噪声。另一方面,功能图片说明强调动作与目的地;不能为了避免重复,误把一个仅有图片的链接变成无名称控件。
用同一张灯具示意,走一遍三种写法
下面是本次制作的本机HTML样例。第一处用图片补充外观,alt为“蓝色灯罩、圆形底座的台灯”;第二处的相邻文字已经完整给出这条信息,图像没有链接,所以用空alt;第三处图片是链接中的唯一内容,alt改为“查看台灯详情”。它们使用同一份原创插画,区别来自用途。

本机Chromium的可访问性树中,第一处具有相应图像名称,装饰图被忽略,图片链接具有“查看台灯详情”的名称。另测了“图片加文字在同一个链接内”的写法:图片空alt,链接仍由文字获得同一名称。键盘Tab可聚焦链接,Enter到达样例详情;禁用JavaScript后链接仍能操作。
这些记录验证的是这份样例的DOM、浏览器可访问性树与键盘行为,不是NVDA、JAWS或VoiceOver的实际朗读,也不是某个WordPress主题的测试结果。真实站点还要按所用浏览器与辅助技术核验阅读体验。
产品图、截图和复杂图,写到什么程度
WAI信息图片说明要求传达图片在语境里的意义,不必逐个描述所有像素。产品细节图若用来定位接口,就写明接口在何处;安装图若说明旋转方向,就把必要方向讲清。不要从外观推断不锈钢牌号、防护等级、适配车型或安全认证,这些信息需要另有资料。
截图的alt可交代界面和要看的状态,操作步骤放在正文中。截图内的重要错误信息若未在正文出现,应提供文字版本。图像里的字很多时,不能只写“后台截图”就认为全部可理解,也不必把整个界面菜单逐字塞进alt。
对图表与复杂流程,WAI复杂图片指南建议短说明加完整文字替代。正文可写出结论、条件、坐标单位和关键关系,必要时提供结构化数据表,并清楚说明它与哪张图对应。长描述需要表格或标题导航时,不宜仅用aria-describedby把整块内容作为一段连续文本读出。
Google的图片最佳实践说明,会结合alt、计算机视觉和页面内容理解图片。写法应有用、信息充分且符合上下文,避免堆关键词;这不是固定字数公式,也不承诺收录。链接文档另指出,图片链接的alt可被用作锚文本,因此“点击这里”或一串产品词都不如准确说明目的。
WordPress媒体库的值,不等于所有页面已同步
WordPress Image区块文档区分两处编辑:在区块设置中改alt,影响该页面或文章中的这张图;在媒体库中填写alt,是以后插入图片时的默认值。不能只改媒体库就推断所有旧文章、图库、主题卡片和页面构建器组件已经更新。
- 按出现位置建清单。记录页面URL、图片实际地址、所属区块或模板、是否可点击、当前alt与预期用途。媒体库记录可作线索,但不是全站使用清单。
- 区分三种状态。没有alt属性、
alt=""和有文字值分别记录。空值先判断是否正确的装饰用途,不统一当错误填满。 - 修改负责输出的位置。单篇图片从对应区块入手;共用模板、图库或插件要查实际数据来源。后台界面会随版本和插件变化,不按一张旧截图盲找开关。
- 保存后看未登录公开页。核原始HTML;若脚本会替换图片,再核渲染DOM。检查图片链接的名称与目标,以及桌面和手机实际选择的变体。
- 按使用清单复查。清缓存后确认新值生效,同时检查其他出现位置是否仍有旧值。只抽查一张图,不能证明全站都已同步。
排查“设置里有、前台却没有”的问题,可参考WordPress输出与后台设置的核对方法,但图片alt与robots是不同字段,不照搬索引指令。图片文件和附件HTML页也要分开,见附件页与媒体文件URL检查。文件名称另按WordPress图片文件名的使用语境核实际地址与引用,不靠改媒体标题推断文件已改名。
SVG、图注和title不要混成同一个字段
通过img加载SVG文件时,仍在img上按用途处理alt;直接写在页面中的内联svg则不是给它随手加一个alt属性。MDN的SVG title说明指出,title可提供短名称,若已有适用的可见文字,也可通过aria-labelledby引用。装饰图标不应制造多余朗读,但包含图标的按钮或链接仍需有明确名称。
图注是页面上的可见说明,alt是对应图片的替代文本,HTML的title工具提示也不能当作alt的通用替代。是否重复要看完整语境,而不是机械规定“有图注就清空alt”。涉及版权时,公开署名与私有授权凭证另按WordPress图片版权和授权记录落实,alt不能代替这些材料。
改完分别验可用性和搜索表现
先确认属性、图像内容、控件名称和键盘操作,再用实际屏幕阅读器检查关键页面。自动检测能找出缺属性等问题,却不能单靠绿色标记判断描述是否准确。自动生成的alt也只适合作待审建议;无法从图片确认的型号或事实,应由资料负责人核实。
搜索观察可以在Search Console效果报告中选合适的搜索类型,并固定页面、国家、设备及可比日期,结合可用查询查看展示与点击;不要只看全站两条总数。报告通常归到Google选定的规范网址,匿名查询、截断与缺失会限制可见范围,不能把每行结果当作某张文件的完整成绩。
保留改动时间、具体位置及同时发生的其他修改。访问改善、重新抓取、图片展示和有效询盘分别观察,前后变化本身不能证明alt导致排名变化。需要梳理主题、插件和媒体输出时,可按项目安排光算的WordPress托管与优化服务;具体内容仍需结合实际图片与页面任务逐处确认。