商品详情页需兼顾性能、SEO、移动端适配、交互响应与可维护性;图片懒加载应优先用原生loading="lazy";JSON-LD须字段合规且动态更新;规格选择器需支持URL参数、无障碍访问;价格库存须区分SSR快照与客户端实时补全。

商品详情页不是“写完就能上线”的静态页面,它必须兼顾加载性能、SEO基础、移动端适配、交互响应和后续维护扩展性。盲目套用模板或堆砌
图片懒加载必须用 loading="lazy" 而不是 JS 插件
多数人一上来就引入 lozad.js 或手写 IntersectionObserver,但现代浏览器(Chrome 76+、Firefox 75+、Safari 15.4+)原生支持 loading="lazy",对商品主图、SKU图、细节图都有效:
@@##@@
注意三点:
-
loading="lazy"对和
生效,不支持背景图或 CSScontent - 首屏关键图(如主图顶部 banner)应去掉该属性,避免白屏
- 服务端渲染(SSR)场景下,若 HTML 初始未包含
src(比如用data-src),loading="lazy"会失效 —— 必须确保初始 HTML 中src已存在
JSON-LD 结构化数据不能只贴在 里就完事
电商页加 JSON-LD 是为了让 Google 展示价格、库存、评分等富摘要,但光有代码不够:
- 必须校验字段有效性:例如
offers.price必须是数字字符串("6999.00"),不能是带¥符号的"¥6,999",否则解析失败 - 库存状态要动态更新:
availability值必须是标准枚举,如"https://schema.org/InStock",不能写中文或自定义值 - 多个 SKU 时,每个变体需独立一个
Product对象,共用同一个sameAs指向 SPU 页面
验证工具用 Google 的 Rich Results Test,别只看控制台没报错就认为 OK。
规格选择器别用纯 CSS 实现交互逻辑
常见错误是把所有规格按钮(颜色、内存、版本)全用 :checked + label 模拟,看似无 JS,实则埋雷:
- 无法响应外部状态变更(比如用户从 URL 参数带入
?color=blue&size=128g,纯 CSS 拿不到 query) - 禁用状态(如“红色 + 512G”缺货)只能靠 class 控制,但无障碍阅读器识别不了
aria-disabled,也不触发focus流 - 选中态无法通过键盘
Tab导航切换,违反 WCAG 2.1
正确做法:用 或 + 少量 JS 绑定状态,配合 aria-checked 和 aria-disabled,既可访问又易扩展。
价格与库存更新必须区分服务端渲染和客户端补全
用户看到的价格,可能来自三个地方:SSR 渲染的初始 HTML、CDN 缓存页、JS 运行后拉取的实时库存。混淆这三者会导致“页面显示有货,下单提示缺货”:
- SSR 输出的价格/库存应为「快照」,标注时间戳(如
data-fetched-at="2024-05-20T14:22:00Z"),并设合理缓存头(max-age=60) - 客户端 JS 启动后,立即用
fetch()请求 /api/product/id/stock,仅更新span[data-role="stock"]等局部区域,不重绘整页 - 库存接口必须带 ETag 或
Last-Modified,前端用cache: 'no-cache'强制校验,避免 CDN 返回过期响应
最常被忽略的是:当用户切规格时,新 SKU 的库存可能从未被 SSR 渲染过 —— 此时必须走客户端请求,且要有 loading 态和失败 fallback(比如显示“暂未获取到库存,请稍后重试”),不能留空或沿用上一个 SKU 的值。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











