跳到主要内容

概述

店面搜索基于查询参数，这些参数决定了搜索结果返回哪些信息以及如何返回。

查询参数可以通过在搜索表单中包含输入字段来使用，并在执行搜索时反映在搜索 URL 中。

您还可以为 theme 添加预测搜索功能，使建议结果在您输入搜索词时立即显示。如需了解预测搜索，请参阅为 theme 添加预测搜索。

查询参数​

搜索查询接受以下参数：

查询参数类型必填说明
qString是搜索查询词。
pageInteger否指定当前搜索结果页码，默认为 1。

搜索表单​

搜索表单可以用具有 action="/search" 属性的 <form> 元素来实现。

📘 提示

建议使用 routes object 来填充 action 属性，以确保多语言店铺使用正确的 URL。

在表单内，您可以为上述每个查询参数添加输入字段，每个输入字段具有以下属性：

  • name="query-parameter"
  • value="parameter-value"
<form action="{{ routes.search_url }}">
  <input type="text" name="q" value="{{ search.terms | escape }}">
  <input type="submit" value="搜索">
</form>

搜索 URL 结构​

执行搜索后，搜索页面的 URL 会相应更新。

例如，使用以下参数进行搜索将返回如下 URL：

属性值
qgift
/search?q=gift