Shopify Video & Feature Media开发:如何单独展示产品视频媒体
实现方案
核心逻辑说明
Shopify的product.media是严格按照后台媒体上传顺序排序的数组,索引从0开始计数:
- 索引0位置 = 第一个上传的媒体,和你定义的“特色图片”规则完全匹配
- 索引1位置 = 第二个上传的媒体,就是你需要固定展示的视频
之前无法正确提取视频的常见原因有两个:一是修改时把视频提取逻辑直接合并到原有featured_media的赋值链路里,替换了特色图的渲染源,导致图片位置出视频、视频位置为空;二是没有做边界判断,遇到媒体数量不足的产品直接触发Liquid渲染报错。
具体代码修改
1. 变量定义调整
完全保留原有特色图片的赋值逻辑,新增独立的视频媒体提取变量,加两层判断避免空值报错:
{%- comment -%} 原有特色图片逻辑保留,无需修改 {%- endcomment -%} {%- assign featured_media = product.selected_or_first_available_variant.featured_media | default: product.featured_media -%} {%- comment -%} 新增第二个媒体提取,加边界判断 {%- endcomment -%} {%- assign product_video_media = nil -%} {%- if product.media.size >= 2 -%} {%- assign candidate_media = product.media[1] -%} {%- if candidate_media.media_type == 'video' or candidate_media.media_type == 'external_video' -%} {%- assign product_video_media = candidate_media -%} {%- endif -%} {%- endif -%}
2. 媒体渲染逻辑调整
去掉原代码中全量循环所有媒体的逻辑,改成在模板对应位置分别传入指定媒体对象渲染。注意Shopify自带的media snippet会自动根据传入的媒体类型判断渲染图片还是视频,不需要单独编写视频渲染逻辑:
{%- comment -%} 模板需要展示特色图片的位置,调用图片渲染 {%- endcomment -%} {% if featured_media %} {% include 'media', media: featured_media, featured_media: featured_media, height: height, enable_image_zoom: enable_image_zoom, image_zoom_size: product_image_zoom_size, image_scale: product_image_scale %} {% endif %} {%- comment -%} 模板需要展示产品视频的位置,调用视频渲染 {%- endcomment -%} {% if product_video_media %} {% include 'media', media: product_video_media, featured_media: featured_media, height: height, enable_image_zoom: false, image_zoom_size: product_image_zoom_size, image_scale: product_image_scale %} {% endif %}
3. 兜底逻辑保留
原代码里的noscript无脚本环境兜底逻辑完全保留,不需要做任何修改:
<noscript> {% capture product_image_size %}{{ height }}x{% endcapture %} <img src="{{ featured_media | img_url: product_image_size, scale: product_image_scale }}" alt="{{ featured_media.alt }}" id="FeaturedMedia-{{ section.id }}" class="product-featured-media" style="max-width: {{ height }}px;" > </noscript>
注意事项
- 不要将视频提取的逻辑合并到
featured_media的赋值管道中,否则会直接替换特色图片的渲染数据源,导致展示位置错乱 - 代码中加的两层判断可以自动兼容媒体数量不足、第二个媒体非视频类型的产品,不会出现渲染报错
- 视频渲染位置关闭了图片缩放交互参数,避免视频元素触发不匹配的交互效果
内容的提问来源于stack exchange,提问作者JulienA
相关产品推荐
相关产品推荐

