语义化HTML结构优于框架,主图轮播用section+role="region"、img需具体alt、按钮必须为button并带aria属性,价格/SKU用语义标签,详情用details,购物车按钮须含data-sku-id和aria-busy。

直接用语义化 HTML 标签搭结构,比套现成框架更可控、SEO 更友好、无障碍支持更扎实——关键不是“怎么写完”,而是“怎么写对”。
主图轮播必须用 section + role="region",别用 div 包 img
轮播不是视觉动效,而是「一组相关图片的集合」。用 div 套图再加 JS 控制,屏幕阅读器根本读不出上下文。
-
section外层加role="region"和aria-label="商品主图轮播",让辅助技术知道这是个独立功能区 - 主图容器必须设
tabindex="0",否则键盘用户无法聚焦、无法用空格/Enter 触发切换 - 每张
img的alt要具体,比如alt="iPhone 15 Pro 钛金属蓝色正面图,无配件",不能写"product-1.jpg"或留空 - 上一张/下一张按钮必须是
button,不是span或div,并加aria-controls="carousel-id"指向轮播容器
价格和 SKU 必须用语义标签包裹,span 或 div 是错的
搜索引擎和结构化数据提取器(如 Google 商品富媒体搜索)依赖明确的语义标记,混在普通文本里等于“不可见”。
- 价格用
span itemprop="price"或至少strong+data-price,数值部分单独包裹,比如<span class="price-value">7999</span><span class="price-unit">元</span> - SKU 选择器禁用
select:它无法自定义高亮态,移动端唤起原生选择器体验割裂;改用fieldset+legend+input type="radio"或button role="radio" - 每次 SKU 变更后,必须同步更新
meta[itemprop="offers"]或 JS 中的price/skuId字段,否则分享链接时抓取的价格可能错位
图文详情模块别用 display: none 折叠,details 是唯一正确解
用 CSS 控制 display: none 或 visibility: hidden,内容仍会被屏幕阅读器读出,搜索引擎也可能判定为隐藏文本而降权。
立即学习“前端免费学习笔记(深入)”;
- 必须用原生
details/summary,它自带键盘支持(Enter/Space 展开)、无需额外 JS、状态可被 JS 监听 - 每个
figure配一个figcaption,写清图示目的,比如figcaption里写 “A17 Pro 芯片能效对比柱状图”,而不是 “参数图” - 如果需要多级折叠(如“规格参数”里再分“外观”“性能”),就嵌套
details,不要自己写 JS 模拟
加入购物车按钮必须带 data-sku-id 和 aria-busy
这个按钮不是装饰,是交易链路起点。缺关键属性会导致状态不一致、无障碍失效、埋点丢失。
- 必须是
button元素,不是a或div;携带data-sku-id="123456",方便 JS 绑定行为和上报 - 点击后要立即设
aria-busy="true"并禁用按钮,防止重复提交;成功后恢复,失败后给出明确错误提示(用aria-live="polite"区域) - 按钮文字不能只写“加入购物车”,应结合当前 SKU,比如“加入购物车(钛金属蓝色 / 256GB)”,避免用户选错后误操作
最容易被忽略的是:所有交互状态变更(SKU 切换、加入购物车、展开详情)都必须同步更新 DOM 属性和结构化数据,不能只改 UI。否则 SEO 抓取、分享卡片、语音助手读取,全都会拿到过期信息。



















