应使用语义化HTML标签构建结构:主图轮播用figure+img并设alt和aria-label;SKU选择器用fieldset+radio而非select;参数表用dl/dt/dd替代table。

直接用语义化 HTML 标签搭结构,比套模板更稳、更易维护,也更容易让 JS 和 CSS 各司其职。别一上来就写 div class="product-container">,浏览器和读屏器根本不知道你在展示什么。
主图轮播必须用 figure + img,别用 background-image
PhotoSwipe、Swiper 这类库只识别 <img src alt="HTML商品详情页制作教程详解" >,用 CSS 的 background-image 会导致缩放错位、懒加载失效、alt 文本丢失——三者都会直接影响 SEO 和无障碍访问。
-
figure是语义上最贴近“一组商品图”的原生标签,配合figcaption可自然描述图组用途(如“iPhone 15 Pro 主图轮播”) - 每张
img必须带真实alt,例如alt="iPhone 15 Pro 钛金属蓝色正面图,无配件",不能是“图片1”或空字符串 - 外层容器加
role="region" aria-label="商品主图轮播",键盘用户按 Tab 键才能聚焦进来 - 移动端需在图片父容器设
style="touch-action: manipulation",否则双指缩放会被浏览器默认滚动拦截
SKU 选择器要用 fieldset + input[type="radio"],禁用 select
select 在 iOS 和部分安卓机型上会唤起原生下拉框,样式不可控、无法高亮已选、不支持多规格联动,电商场景下基本等于放弃交互一致性。
- 用
fieldset包裹所有规格项,legend写“颜色”“内存”等维度名,天然支持屏幕阅读器分组朗读 - 每个选项用
input type="radio" name="color" value="black",搭配label实现点击区域扩大 - 禁用售罄规格时,除了加
disabled,必须同步设aria-disabled="true",否则读屏器仍会把它当作可操作项 - JS 中用
Map存specs.join('|') → skuObj映射,比遍历数组查匹配快 3 倍以上,尤其 SKU 数超 20 个时明显
参数表改用 dl + dt + dd,别用 table
table 是为二维关系数据(如多商品横向对比)设计的,单商品的“品牌:Apple”“重量:171g”这类键值对,用 dl 才符合语义,且天然响应式、无障碍友好。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
立即学习“前端免费学习笔记(深入)”;
-
dt放属性名(如“芯片”),建议加font-weight: bold;dd放值(如“A17 Pro”),可用 CSS Grid 对齐,不用 hack - 移动端无需额外 JS,直接用
display: grid; grid-template-columns: max-content 1fr就能两栏对齐 - 若必须兼容旧版 Safari(display: -ms-grid 回退,但 2026 年绝大多数设备已无此顾虑
- 绝对不要给
dl加role="presentation"——它本就是语义化列表,加了反而干扰读屏器
标签页切换必须用 JS 控制显隐,别依赖 :target 或 radio
纯 CSS 方案在商品详情页容易失控::target 会污染 URL 锚点、干扰页面滚动;input[type="radio"] 无法与后端模板或现代框架对齐,且状态不可编程更新。
- 每个标签按钮用
button[data-tab="desc"],对应内容区用div[data-tab="desc"][role="tabpanel"],ID 与aria-controls匹配 - 隐藏非活跃面板时,用
visibility: hidden; position: absolute; clip: rect(0 0 0 0),而不是display: none,否则读屏器会跳过内容 - 异步加载时,点击立刻设
button.disabled = true,并用AbortController中止前一个请求,避免重复发“评价”接口 - 首次加载必须手动激活第一个标签,否则页面空白——这不是 bug,是未初始化导致的必然结果
真正难的不是写出来,而是让每张图、每个按钮、每行参数,在任何设备、任何辅助技术、任何网络条件下,都保持语义准确、状态同步、行为可预测。细节藏在 aria- 属性里、藏在 loading="lazy" 的时机里、藏在 Map 查表的键拼接方式里。


















