商品详情页HTML结构须围绕用户决策链组织语义层级:主图/标题/价格置于DOM顶部,用main包裹,section包轮播(加aria-label),h1唯一且为商品标题,价格促销用aside,SKU用form+带data属性的button,参数表用dl/dt/dd,图片须设width/height和loading属性,SSR需内联style="visibility:hidden"防闪屏。

商品详情页的 HTML 结构不是按「从上到下写完就行」堆出来的,而是要围绕用户决策链组织语义层级:主图/标题/价格必须在 DOM 顶部且可被屏幕阅读器优先读取,参数表和 SKU 选择需具备明确的父子关系,否则 JS 绑定库存、无障碍访问、SEO 抓取都会出问题。
怎么用语义化标签组织核心区块
别用一堆 div 套娃。主信息区必须用 main 包裹,内部按逻辑拆解:
-
section包住商品主图轮播(加aria-label="商品主图轮播") -
h1只能有一个,且必须是商品标题,紧贴在轮播下方 - 价格、促销信息用
aside,而非div——它语义上属于“辅助内容”,利于 SEO 和阅读器分流 - 规格选择模块用
form包裹,每个规格项是button type="button",带data-spec-key和data-spec-value - 参数表格改用
dl/dt/dd,比table更轻量、更语义,也更容易响应式断行
为什么不能把 SKU 选项写死在 HTML 里
硬编码 看似简单,但会导致三个实际问题:
- 后端无法动态控制某颜色是否售罄——你得靠 JS 查表判断,但 DOM 里没留
data-stock="0"这类钩子 - 无障碍场景下,屏幕阅读器读不出“红色(已售罄)”,因为禁用状态只靠
class="disabled",没配aria-disabled="true" - 多语言切换时,按钮文字变了,但 JS 里还拿着 “红色” 字符串去查库存映射,直接失效
正确做法是让每个 button 带全元数据:,JS 只读属性,不依赖文本内容。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
图片区域的 HTML 必须提前声明宽高和加载策略
商品图若没设 width 和 height,加载时会触发 CLS(累计布局偏移),用户滑动中页面突然上跳;若没加 loading="lazy",首屏外图片也会抢带宽,拖慢 LCP。
- 轮播图容器统一用
aspect-ratio: 3/4(或内联style="aspect-ratio: 3/4"),避免 CSS 计算延迟 - 每张图必须带
width和height属性(如),值按原始图比例缩放即可
- 所有非首屏图加
loading="lazy",首屏图显式写loading="eager",防止 Safari 误判 - 慎用
srcset+sizes:移动端多数情况一张 2x 图 +width/height就够,复杂配置反而增加解析开销
怎么让服务端渲染(SSR)不闪屏
SSR 输出的 HTML 如果和客户端 JS 初始化后的结构不一致,就会出现“先显示原始列表,再跳成轮播”的闪屏。关键在两个控制点:
- 轮播容器初始加
style="visibility: hidden",Swiper 实例onInit回调里再移除 - SKU 按钮默认加
disabled和aria-disabled="true",等 JS 加载并校验完库存后再启用 - 参数表(
dl)内容由后端直出,不留给 JS 拼接——避免 JS 失效时整块空白 - 所有动态模块(阶梯价格、评价列表)用
标签包裹,JS 渲染前不插入 DOM
最易被忽略的是:轮播容器的 visibility: hidden 必须写在 HTML 内联 style 里,不能靠外部 CSS 控制——否则 SSR 阶段 CSS 还没加载,照样闪。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










