如何在Shopify Liquid中对Metaobjects进行分页？

问题背景 #

在Shopify商品模板中结合Metaobjects与Metafields渲染信息时，遇到shop.metaobjects.fabric_colors.values仅返回前50条数据的限制，实际fabric_colors Metaobject有59条激活状态的条目。尝试使用.offset和.limit方法时Liquid报错，官方相关文档不足，怀疑只能通过Storefront API实现分页，但对Liquid不熟悉。

当前核心代码片段：

{%- capture hex_color -%}
{% assign current_fabric_colors = shop.metaobjects.fabric_colors %}
{% for color in current_fabric_colors.values %}
   {% if color.name == handle[1] %}
       color.name
   {% endif %}
{% endfor %}
{%- endcapture -%}

可行解决方案 #

方案1：优化查询逻辑（避开全量遍历） #

当前代码是遍历所有颜色匹配handle[1]，其实可以直接通过Metaobject的handle字段精准获取目标条目，完全避开50条数据限制：

{%- capture hex_color -%}
{% assign target_color_handle = handle[1] %}
{% assign target_color = shop.metaobjects.fabric_colors[target_color_handle] %}
{% if target_color %}
  {{ target_color.name }}
{% endif %}
{%- endcapture -%}

注：需确保fabric_colors Metaobject的每条条目都设置了正确的handle值，且与handle[1]匹配。

方案2：通过Storefront API获取全量数据 #

如果确实需要获取全部59条数据，Liquid目前不支持Metaobjects的分页/偏移查询，只能通过Storefront API实现：

• 前端用JavaScript调用Storefront API的metaobjects查询，通过first和after参数实现分页（单次最多可获取100条，足够覆盖现有数据量）
• 将获取到的全量数据缓存到页面后，再执行后续匹配逻辑

方案3：拆分Metaobject（临时替代方案） #

若暂时不想使用API，可将fabric_colors拆分为两个Metaobject（比如fabric_colors_1和fabric_colors_2），每个包含不超过50条条目，再在Liquid中合并两个集合：

{%- capture hex_color -%}
{% assign color_sets = shop.metaobjects.fabric_colors_1.values | concat: shop.metaobjects.fabric_colors_2.values %}
{% for color in color_sets %}
   {% if color.name == handle[1] %}
       {{ color.name }}
   {% endif %}
{% endfor %}
{%- endcapture -%}

关键说明 #

• Shopify Liquid中shop.metaobjects.[handle].values默认最多返回50条数据，且当前不支持.limit/.offset等分页方法，属于平台现有限制
• 优先推荐方案1，精准查询比全量遍历性能更优，同时从根源避开数据量限制问题

内容的提问来源于stack exchange，提问作者stftnk