案例作品集 浏览精选项目

WESWOO 提供 Shopify Plus 项目开发费抵扣,至多 US$4,800

开发知识库 / 商品详情与组合购买

商品详情与组合购买

先同步型号与变体事实,再处理媒体、配件和规格信息。

缩略图、主图与演示视频

媒体列表先按实际资源输出;增强缩略图时保持当前媒体与变体关系。信息图的关键参数另用 HTML 说明,视频不阻塞商品文字和购买入口。

数据与依赖

  • product.media 与资源 media_type。
  • 说明性 alt 来自该型号图片资料。

交互逻辑

  • 图片可读,视频由用户控制。
  • 切换变体时定位其关联媒体,并保留无图回退。
示例代码 · snippets/ww-media.liquid
Liquid · WESWOO
<ol aria-label="Product media">
  {% for media in product.media %}
    <li id="Media-{{ section.id }}-{{ media.id }}">
      {% case media.media_type %}
        {% when 'image' %}
          {{ media | image_url: width: 1400 | image_tag: widths: '480, 800, 1400', sizes: '(max-width: 749px) 100vw, 60vw', loading: 'lazy' }}
        {% when 'video' %}
          {{ media | video_tag: controls: true, autoplay: false, preload: 'none' }}
        {% else %}
          <a href="{{ product.url | escape }}">View media on the product page</a>
      {% endcase %}
    </li>
  {% endfor %}
</ol>

验收检查

  • 核缩略图选中、键盘、触摸与主图。
  • 首图不延迟;下方媒体可按需加载。

示例是媒体列表;首屏图片需根据实际位置改用 eager,轮播和焦点管理接现有媒体组件。

先理解,再整合,最后验证

  1. 选择模块,确认数据和输入输出。
  2. 将片段接入当前主题或框架。
  3. 用真实变体、市场和失败恢复场景验收。

示例按 Shopify Online Store 2.0 主题编写;Headless 使用单独的数据与版本边界。代码片段需接实际字段、主题和语言文件。

架构参考

示例由 WESWOO 编写,结合 Shopify 官方文档和固定版本的仓库参考。采用仓库代码时应保留适用许可。

Shopify/dawn · 许可commit 3e9ee2281dc4 · Shopify 集成主题的限定许可;参考架构,不复制仓库实现。
Shopify/hydrogen · 许可commit 9e358a2462ba · MIT;采用实质代码时保留版权与许可。

依据核对 2026-11-12