商品图替代文字怎么写:附 Shopify 批量处理办法

替代文字(alt text)是读屏软件替视障用户“看”图的那句话。商品图没有它,视障用户就不知道你卖的东西长什么样。

发布于 · A11yPass 无碍达

在我们抽查的 20 个中国品牌欧洲站里,16 个有图片缺少替代文字。它对应 WCAG 2.1 的第一条成功标准 1.1.1“非文本内容”,属于 A 级,也是美国 ADA 网站诉状里出现最多的问题之一。好消息是它最好改:不用动设计,只要把每张图该说的话写上。

替代文字是做什么的

视障用户用读屏软件浏览网页,读到图片时,软件会念出这张图的替代文字。没有替代文字时,有的软件念文件名(“IMG_2041.jpg”),有的直接跳过。对一个靠图片卖货的独立站来说,这等于商品图对这部分用户完全不存在。

对比三种替代文字。没有替代文字时读屏软件念出文件名 IMG_2041.jpg,不合格;堆关键词的写法不合格;描述商品本身的写法“便携户外电源正面,显示屏亮着,旁边是折叠太阳能板”合格。
同一张商品图,只有第三种写法对视障用户有用。

先判断这张图要不要写

不是每张图都要写一大段。W3C 给过一个判断流程,独立站上可以简化成四个问题:

替代文字判断流程:第一问图片是否传达信息,否则是纯装饰,写空的 alt;第二问是不是链接或按钮,是就写点击后去哪里,比如购物车;第三问图里有没有文字,有就把文字写出来;第四问是不是商品图,是就写品类、外观和关键差异。
按这四个问题依次判断,大部分图片都能归类。
  • 纯装饰的图:背景纹理、分隔线、和旁边文字重复的图标,写空的替代文字(alt=""),读屏软件会直接跳过。注意是“空”,不是删掉 alt 属性。
  • 当链接或按钮用的图:写点击后发生什么,比如“购物车”“搜索”“返回首页”,不要写“购物车图标”。
  • 图上有字的 Banner:把图上的文字原样写出来,比如“双十一全场 8 折,11 月 11 日截止”。
  • 商品图:写这件商品本身,见下一节。

商品图怎么写

可以按“品类 + 外观 + 角度或场景 + 和其他图的区别”来写,一两句话:

图片不好的写法好一些的写法
主图户外电源便携户外电源正面,深灰色机身,显示屏亮着
细节图细节户外电源侧面的接口:两个 USB-C、一个车充口
场景图露营 户外电源 便携户外电源放在帐篷旁的折叠桌上,正在给台灯供电
颜色变体图片 2同款户外电源,米白色机身

几个常见错误:

  • 以“图片”“照片”开头。读屏软件已经会说“图片”,再写一遍是重复。
  • 堆关键词。替代文字是给人听的,塞一串搜索词会被读出来,体验很差,搜索引擎也不会因此给更高排名。
  • 每张图都写成商品标题。用户分不清这是主图、细节还是场景。
  • 写主观评价,比如“超好看的户外电源”。

在 Shopify 里改

单张修改:后台进入商品,点开某张图片,在“添加替代文字”里填写并保存。改完要去前台确认主题真的把这个字段输出到了页面上,个别第三方主题或页面搭建应用会用自己的图片字段,后台填了前台也没有。

商品多的时候,可以用 CSV 批量处理:

批量流程五步:导出商品 CSV;按标题、变体和属性生成草稿;人工抽检,改掉不准确的;填回 Image Alt Text 列并覆盖导入;前台用读屏软件抽查。第 3、5 步需要人工。
批量处理时,人工抽检和前台复查这两步不能省。
  1. 先导出全部商品 CSV,另存一份原始文件当备份。
  2. CSV 里每张图片占一行,图片描述在 Image Alt Text 列。按商品标题、变体(颜色、尺寸)和图片顺序生成描述草稿,可以用 AI 辅助。
  3. 人工抽检:至少每个商品看一遍主图,颜色、型号、配件写错的改掉。
  4. 填回 Image Alt Text 列,导入时勾选覆盖同 handle 的现有商品。
  5. 去前台抽几个商品页,用读屏软件或我们的检测工具确认描述已经生效。

导入会覆盖 CSV 里有的字段。只改 Image Alt Text 列,其他列保持导出时的原样,避免误改价格和库存。

改完怎么验收

用我们的免费在线检测跑一遍首页、商品页和分类页,“图片缺少替代文字”这一项应该清零。再打开手机的读屏功能(iPhone 的旁白、安卓的 TalkBack)听一个商品页,确认读出来的内容说得通。逐项检查的其他内容见 WCAG 2.1 AA 检查清单。

常见问题

替代文字要写多长?

WCAG 没有规定字数。商品图一般一两句话就够,写清品类、外观和关键差异;更详细的参数放在商品描述正文里。

多语言站点要每种语言都写吗?

要。替代文字和页面语言一致,德语站用德语、法语站用法语,否则读屏软件会用错误的发音读出来。

AI 生成的描述能直接用吗?

可以当草稿,不能直接上线。自动生成的描述常把颜色、型号、配件认错,至少要按商品逐个抽检。

资料来源

  1. W3C: Web Content Accessibility Guidelines (WCAG) 2.1
  2. W3C WAI: An alt Decision Tree
  3. TestParty: How to Add Alt Text to All Shopify Products (Bulk Guide)

本文整理技术要求和公开数据,不构成法律意见。涉及诉讼和法律义务的问题,请咨询当地律师。