Statamic CMS 本地搜索分页结果总数问题解析

问题背景

在使用Statamic CMS的本地搜索功能时，开发者发现当搜索结果进行分页处理时，total_results变量返回的是当前页面的结果数量，而非整个搜索查询的总结果数。这与开发者的预期行为不符，容易造成混淆。

技术细节分析

Statamic的本地搜索驱动（local driver）在处理分页查询时，total_results变量实际上表示的是当前页面的结果数量。这个设计可能与一些开发者的直觉相悖，因为变量名称暗示它应该返回总结果数。

正确获取结果总数的方法

经过官方确认，要获取跨所有页面的总结果数，应该使用{{ paginate:total_items }}这个变量。这个变量会返回完整的、未分页前的搜索结果总数。

实际应用示例

假设我们有一个产品搜索页面，每页显示2个结果：

{{ search:results index="products" paginate="2" as="results" }}
  <h1>{{ paginate:total_items }} 总结果数</h1>
  <p>当前页结果数: {{ total_results }}</p>
  
  {{ results }}
    <h2>{{ title }}</h2>
  {{ /results }}

  {{ paginate:auto_links }}
{{ /search:results }}

在这个例子中：

• {{ paginate:total_items }}会显示所有匹配产品的总数
• {{ total_results }}则显示当前页面上的产品数量

最佳实践建议

1. 变量命名清晰：在自定义模板中，建议使用更具描述性的变量名来避免混淆
2. 文档查阅：使用新功能时，仔细阅读官方文档中的变量说明
3. 测试验证：对于分页功能，建议测试不同结果数量下的表现

总结

Statamic CMS的搜索分页功能提供了两种不同的计数变量：total_results表示当前页结果数，而paginate:total_items表示总结果数。理解这一区别对于正确实现搜索分页功能至关重要。开发者应根据实际需求选择合适的变量来显示结果数量信息。