商品详情页的alt属性必须精准匹配图片在当前上下文中的具体功能。主图轮播需包含型号、颜色、视角等决策信息;SKU图标要描述点击行为;信息图按位置重写alt;装饰图用alt=""并配role="presentation";动态渲染须防undefined;核心是图消失后用户仍能理解其支撑的文案与决策。

商品详情页的 alt 属性不是“填一个描述就行”,而是必须匹配图片在当前上下文中的**具体功能**——填错等于主动放弃图片搜索流量,且无障碍用户会完全误解页面意图。
主图轮播里的 img 怎么写 alt
主图不是“展示商品”,而是“让用户确认这是你要买的那台设备”。浏览器加载失败时,alt 是用户唯一能依赖的信息源。
-
alt必须包含型号、颜色、视角、配件状态等可决策信息,例如:alt="iPhone 16 Pro 256GB 深空黑色正面实拍图,无保护壳,灵动岛显示时间与天气" - 避免泛化词:“产品图”“高清大图”“正面图”——这些对用户没用,对爬虫是噪音
- 轮播中每张图的
alt必须不同:背面图写“后置三摄+钛合金中框特写”,细节图写“USB-C 接口金属触点与线缆插拔示意” - 禁止 fallback 到文件名:
alt="product-007.jpg"在 Lighthouse 审计中直接报错,且 Google 不索引
SKU 选择器图标和功能图的 alt 写法
这类图不传递“内容”,而是触发“动作”——alt 描述的是用户点击后会发生什么,不是图长什么样。
- 颜色 swatch 图标:
alt="选择午夜蓝配色",不是alt="蓝色小方块" - 内存选项按钮:
alt="升级至 512GB 存储空间",而非alt="512GB 标签" - “加入购物车”按钮若含图标:
alt="将 iPhone 16 Pro 加入购物车",不能省略主体对象 - 禁用状态下的图标(如缺货):
alt="当前暂无 1TB 版本库存",提供有效反馈而非仅说“不可用”
图文详情模块中信息图与装饰图的 alt 区分
同一张图在详情页不同位置,alt 可能要重写——因为它的语义角色变了。
立即学习“前端免费学习笔记(深入)”;
- 参数对比图放在“性能”章节:
alt="A18 Pro 与 A17 Pro 能效比柱状图:同负载下功耗降低 22%,横轴为测试场景,纵轴为毫瓦" - 同一张图若出现在“包装清单”下方,则应改为:
alt="iPhone 16 Pro 标准包装内容:手机本体、USB-C 线缆、无充电器" - 纯装饰性分割线或 SVG 背景:
alt=""(空字符串),且必须配合role="presentation"或改用 CSSbackground-image - 误写
alt="decorative"或alt=" "(带空格)会被读屏软件朗读为“decorative”或“空白”,属于无障碍缺陷
动态渲染(React/Vue)中 alt 的 fallback 陷阱
模板里直接绑定未定义字段,会导致 alt="undefined" 或空属性,Lighthouse 和 axe 工具 100% 报错,且 Google 视为缺失替代文本。
- React 中安全写法:
alt={item.imageDescription || "无描述图片"},避免裸写alt={item.imageDescription} - Vue 中用
:alt="item.alt || ''",空字符串比null或undefined更可控 - 服务端渲染(如 Next.js)需确保数据接口返回字段非空;CMS 后台必须强制填写「图片说明」字段,未填则后端输出
alt="",而非 fallback 到文件名或硬塞alt="image" - 注意:JS 动态插入的轮播图、放大镜图、360° 视角图,常被忽略
alt设置——它们和静态图一样需要语义
最难的部分不是写什么,而是在每次插入图片前停顿半秒,问自己:“如果这张图彻底消失,用户还能不能知道它本该支撑哪一句文案、影响哪一个购买决策?” 这个判断没法交给工具,但漏掉一次,SEO 和无障碍就同时掉一档。



















