Shopify Liquid 按标签筛选博客文章并实现分页的方案咨询
可行实现方案
方案1:纯Liquid实现(推荐,无额外开发成本,不影响原有标签页)
你之前where过滤器未生效、分页基数不对的核心原因是直接对全量blog.articles执行分页,过滤逻辑后置,正确操作是先筛选出符合标签的文章数组,再对该数组执行分页,同时加判断逻辑隔离原有页面逻辑:
- 给你创建的7个独立博客分类页面,各新增一个页面级自定义元字段(metafield),类型选单行文本,命名为
custom_blog_tag,分别填入每个页面对应要筛选的博客标签值。 - 替换原有代码为如下版本,代码会自动判断当前页面类型,自定义分类页走过滤分页逻辑,原有标签页、博客默认页仍走原有逻辑,不会互相影响:
<div id="article-index-card-section" class="g-flex"> {% assign blog = blogs.{blog_id} %} {% assign target_tag = page.metafields.custom.custom_blog_tag | default: nil %} {% if target_tag != nil %} <!-- 自定义7个分类页走标签过滤逻辑 --> {% assign tagged_articles = blog.articles | where: "tags", target_tag %} {% paginate tagged_articles by 6 %} {% for article in tagged_articles %} <div class="article-index-card g-vertical"> <div style="display: flex; flex-direction: column;"> <img class="article-index-card-image" src="{{ article.image.src | img_url: 'master' }}"> <div class="article-index-card-text"> <h4>{{ article.title }}</h4> <p class="t-body">{{ article.excerpt }}</p> </div> </div> <div class="article-index-card-btn btn"> <a href="{{ article.url }}">Learn More</a> </div> </div> {% endfor %} <div> {{ paginate | default_pagination: next: '>', previous: '<' }} </div> {% endpaginate %} {% else %} <!-- 原有博客页、标签页走默认逻辑 --> {% paginate blog.articles by 6 %} {% for article in blog.articles %} <div class="article-index-card g-vertical"> <div style="display: flex; flex-direction: column;"> <img class="article-index-card-image" src="{{ article.image.src | img_url: 'master' }}"> <div class="article-index-card-text"> <h4>{{ article.title }}</h4> <p class="t-body">{{ article.excerpt }}</p> </div> </div> <div class="article-index-card-btn btn"> <a href="{{ article.url }}">Learn More</a> </div> </div> {% endfor %} <div> {{ paginate | default_pagination: next: '>', previous: '<' }} </div> {% endpaginate %} {% endif %} </div>
注意:元字段填写的标签值要和文章实际设置的标签大小写、拼写完全一致,where过滤器即可正常生效。
方案2:Section Render API简化实现(适合博客文章量超过50篇的场景)
你之前了解的接口返回整页HTML是因为没有指定section参数,调整后无需复杂解析:
- 将上面的标签过滤文章渲染逻辑单独抽成一个独立section,命名为
custom_tagged_article_list.liquid,仅保留文章循环、分页代码,不要页面头部、底部等冗余布局。 - 前端请求地址改为
/blogs/{博客ID}/tagged/{目标标签}?section_id=custom_tagged_article_list&page={页码},该接口返回的就是单独的文章列表HTML片段,直接替换当前页面的文章容器内容即可实现无刷新分页,无需额外解析逻辑。
内容的提问来源于stack exchange,提问作者Jason
相关产品推荐
相关产品推荐

