AnQiCMS如何让搜索结果在页面上进行分页展示？

在AnQiCMS中，为网站的搜索结果实现分页展示是一项提升用户体验和优化网站结构的重要功能。AnQiCMS强大的模板标签系统让这一过程变得直观且高效。通过合理运用archiveList和pagination这两个核心标签，您可以轻松构建功能完善的搜索结果页面。

核心机制：archiveList 标签与分页类型

AnQiCMS提供了archiveList标签作为核心工具，用于检索并展示网站的各类内容，包括搜索结果。当我们需要在搜索结果页实现分页时，只需在archiveList标签中设置type="page"参数。这个参数的设定，使得archiveList不仅会返回符合条件的文档列表，还会自动处理分页所需的数据，为后续的分页导航打下了基础。

对于搜索关键词的处理，archiveList标签内置了q参数。您可以直接在模板中指定搜索词，但更智能和常见的做法是，当用户通过搜索表单提交关键词时，AnQiCMS会从URL的查询参数（例如q=关键词）中自动识别并应用这些搜索条件，无需在模板中额外手动获取或处理。这使得内容列表能够根据用户输入的关键词动态调整，同时为后续的分页功能提供了准确的数据源。

构建搜索表单

一个功能完善的搜索功能首先需要一个设计合理的HTML搜索表单。在AnQiCMS中，这个表单的设计与常规HTML表单并无二致，关键在于几个核心属性的设置。

首先，表单的method属性应设置为"get"，确保搜索请求以GET方式发送，以便关键词能通过URL传递。其次，action属性通常指向系统的搜索页面路径，例如"/search"。最重要的是，搜索关键词输入框的name属性必须设置为"q"，这是AnQiCMS默认识别搜索词的字段名，确保系统能够正确地获取用户输入的搜索词。

一个典型的搜索表单示例如下：

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

在这个例子中，value="{{urlParams.q}}" 的使用可以确保在用户提交搜索后，搜索框中仍然显示他们之前输入的关键词，提升用户体验。

展示搜索结果列表

搜索结果的展示通常发生在专门的模板文件中。根据AnQiCMS的模板约定，对于搜索结果页，系统默认查找/template目录下的search/index.html文件。您所有的搜索结果展示逻辑都应集中在这个文件中。

在这个模板中，我们会再次运用archiveList标签来获取并渲染匹配搜索条件的文档。结合之前提到的type="page"参数，archiveList将返回一个包含分页信息的文档列表。limit参数则用于控制每页显示多少条搜索结果。

通过for循环遍历archives变量，我们可以逐一展示每条搜索结果的标题、描述、链接等信息。如果当前搜索结果为空，{% empty %}标签内的内容将提供一个友好的提示。

以下是一个展示搜索结果列表的示例代码片段：

<div>
{% archiveList archives with type="page" limit="10" %} {# q参数无需手动指定，系统会从URL自动获取 #}
    {% for item in archives %}
    <li>
        <a href="{{item.Link}}">
            <h5>{{item.Title}}</h5>
            <div>{{item.Description}}</div>
            <div>
                <span>{% categoryDetail with name="Title" id=item.CategoryId %}</span>
                <span>{{stampToDate(item.CreatedTime, "2006-01-02")}}</span>
                <span>{{item.Views}} 阅读</span>
            </div>
        </a>
        {% if item.Thumb %}
        <a href="{{item.Link}}">
            <img alt="{{item.Title}}" src="{{item.Thumb}}">
        </a>
        {% endif %}
    </li>
    {% empty %}
    <li>
        很抱歉，没有找到与您搜索关键词相关的结果。
    </li>
    {% endfor %}
{% endarchiveList %}
</div>

实现优雅的分页导航

在展示搜索结果列表之后，为了方便用户浏览更多结果，分页导航是必不可少的一环。AnQiCMS提供了pagination标签，它能够智能地根据archiveList标签返回的分页数据，自动生成完整的页码导航。

pagination标签通常会返回一个pages对象，其中包含了首页、上一页、下一页、末页以及一个中间页码数组等信息。您可以根据这些信息灵活地构建分页链接。

show参数允许我们控制中间页码区域显示的页码数量。例如，show="5"会显示当前页附近的5个页码，帮助用户快速定位。通过遍历pages.Pages数组，结合item.IsCurrent属性，可以高亮显示当前页码，从而提供清晰的导航体验。

以下是一个分页导航的典型代码示例：

<div>
    {% pagination pages with show="5" %}
    <ul>
        <li>总数：{{pages.TotalItems}}条，总共：{{pages.TotalPages}}页，当前第{{pages.CurrentPage}}页</li>
        <li class="page-item {% if pages.FirstPage.IsCurrent %}active{% endif %}"><a href="{{pages.FirstPage.Link}}">{{pages.FirstPage.Name}}</a></li>
        {% if pages.PrevPage %}
            <li class="page-item"><a href="{{pages.PrevPage.Link}}">{{pages.PrevPage.Name}}</a></li>
        {% endif %}
        {% for item in pages.Pages %}
            <li class="page-item {% if item.IsCurrent %}active{% endif %}"><a href="{{item.Link}}">{{item.Name}}</a></li>
        {% endfor %}
        {% if pages.NextPage %}
            <li class="page-item"><a href="{{pages.NextPage.Link}}">{{pages.NextPage.Name}}</a></li>
        {% endif %}
        <li class="page-item {% if pages.LastPage.IsCurrent %}active{% endif %}"><a href="{{pages.LastPage.Link}}">{{pages.LastPage.Name}}</a></li>
    </ul>
    {% endpagination %}
</div>

通过上述步骤，您的AnQiCMS网站就能拥有一个功能完善、用户友好的搜索结果分页展示功能。这不仅提升了用户在网站上的浏览体验，也有助于搜索引擎