如何使用`archiveList`标签在前端页面进行关键词搜索（`q`参数）来过滤文档？

解锁AnQiCMS：巧用archiveList标签在前端页面实现关键词搜索与内容过滤

作为一名资深的网站运营专家，我深知一个高效、灵活的内容管理系统对企业的重要性。AnQiCMS，这个基于Go语言开发的系统，凭借其卓越的性能和丰富的功能，正成为越来越多中小企业和内容运营团队的首选。在如今信息爆炸的时代，用户能否快速找到所需内容，直接关系到网站的用户体验和转化率。今天，我们就来深入探讨AnQiCMS中一个非常实用且强大的功能——如何利用archiveList标签的q参数，轻松实现前端页面的关键词搜索与内容过滤。

理解archiveList标签的强大与灵活

在AnQiCMS的模板体系中，archiveList标签无疑是内容展示的核心利器。它就像一个万能的内容查询机，能帮助我们根据多种条件，比如文档模型ID（moduleId）、分类ID（categoryId）、推荐属性（flag）等，罗列出我们所需的文章和产品。无论是展示最新动态、热门文章，还是特定分类下的产品列表，archiveList都能游刃有余地完成任务。

它不仅支持灵活的排序方式（order），比如按最新发布或浏览量排序，还能精确控制显示数量（limit）。但其能力远不止于此。当我们需要实现更高级的内容互动，比如让用户主动搜索站内信息时，q参数就闪亮登场了，它将archiveList从一个静态的内容展示工具，升级为一个强大的动态内容过滤引擎。

核心功能：q参数——前端关键词搜索的秘密武器

简而言之，q参数是archiveList标签中专门用于接收关键词搜索请求的参数。当你希望用户在前端输入某个词，网站就能智能地筛选出标题包含该词的文档时，q参数就是你的不二选择。这意味着，用户只需在搜索框中输入他们感兴趣的关键词，系统便能迅速匹配并呈现相关的内容列表，大大提升了内容的可发现性。

值得注意的是，为了充分发挥其搜索过滤和分页展示的能力，q参数通常与type="page"这个列表类型搭配使用。type="page"告诉archiveList，当前是一个需要分页的列表，它会智能地配合分页标签（pagination）一起工作，为搜索结果提供完整的翻页功能。

AnQiCMS的智能之处在于，如果页面的URL中已经包含了q=关键词这样的查询参数，archiveList标签在type="page"模式下会自动识别并使用这个关键词进行过滤，无需我们在标签内部额外指定q参数。这种设计极大地方便了开发者，让搜索功能的实现变得更为简洁高效。

实战演练：一步步构建前端关键词搜索功能

接下来，我们通过一个简单的例子，来演示如何在AnQiCMS中实现一个基本的关键词搜索功能。

1. 创建搜索表单

首先，我们需要在前端页面上提供一个直观的搜索入口，通常是一个HTML表单。这个表单可以放置在网站的任何位置，比如导航栏、侧边栏或专门的搜索页面。

<form method="get" action="/search">
    <div class="search-box">
        <input type="text" name="q" placeholder="请输入搜索关键词" value="{{urlParams.q}}">
        <button type="submit">搜索</button>
    </div>
</form>

在这个表单中：

• method="get"：表示使用GET方法提交表单，搜索关键词会附加到URL的查询字符串中（例如 /search?q=关键词）。
• action="/search"：指定了搜索结果页面将是 /search。请确保您的AnQiCMS模板目录下有search/index.html文件，或者通过后台伪静态规则将搜索请求路由到正确的模板。
• name="q"：这是至关重要的一点，它定义了关键词输入框的名称，与archiveList标签的q参数相对应。
• value="{{urlParams.q}}"：这一部分是一个小技巧，它能确保用户在提交搜索后，搜索框中仍然显示他们之前输入的关键词，提升用户体验。

2. 展示搜索结果

接下来，就是配置搜索结果的展示页面。假设我们有一个search/index.html模板专门用于显示搜索结果。

在这个模板中，我们会使用archiveList标签来动态获取并渲染符合搜索条件的文档列表。请看下面的示例代码：

”`twig {# search/index.html 模板内容示例 #}

{# 引入公共头部，通常包含搜索表单自身 #} {% include “partial/header.html” %}

<h1>搜索结果</h1>

{# 使用 archiveList 标签获取搜索结果 #}
{% archiveList archives