文档列表页面如何实现按关键词搜索和显示结果？

在日益庞大的网站内容面前，如何帮助访客快速精准地找到所需信息，是提升用户体验和网站价值的关键。安企CMS（AnQiCMS）深谙内容管理之道，为我们提供了功能强大且灵活的关键词搜索机制，让文档列表页面能够轻松实现按关键词搜索并优雅地呈现结果。

理解安企CMS的搜索核心：archiveList标签的妙用

安企CMS实现关键词搜索的核心在于其强大的模板标签体系，特别是archiveList标签与q参数的巧妙结合。当我们网站的内容不断增长，访客希望通过关键词快速检索时，安企CMS能够通过archiveList标签来精准地筛选出包含特定关键词的文档，并将其呈现在搜索结果页面。这个过程对模板开发者而言非常直观，无需复杂的编程即可实现。

构建用户友好的搜索表单

首先，我们需要在网站中提供一个搜索入口，这通常是一个搜索框。在安企CMS中，构建这样的搜索表单非常简单，它是一个标准的HTML <form> 标签。为了让搜索引擎友好，并方便用户分享搜索结果，我们通常会选择 GET 方法来提交表单。

以下是一个典型的搜索表单示例，你可以将其放置在网站的页眉、侧边栏或任何希望提供搜索功能的位置：

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

在这个表单中，action="/search" 指明了搜索结果页面通常对应的URL路径，而 input 元素的 name="q" 是一个关键点，它告诉安企CMS将用户输入的文本作为搜索关键词。value="{{urlParams.q}}" 这一部分则是一个小技巧，它能让搜索框在搜索结果页面时，自动显示用户上次输入的关键词，极大地提升了用户体验。

在文档列表页面展示搜索结果

当用户提交搜索表单后，网站会跳转到/search页面。在这个页面对应的模板文件（通常是 search/index.html 或 search.html），我们需要利用 archiveList 标签来获取并展示搜索结果。

archiveList 标签通过 type="page" 参数开启分页模式，并通过 limit 参数定义每页显示的文档数量。更智能的是，如果URL中携带着 q=关键词 的查询参数，archiveList 标签会自动捕获并使用这个关键词进行搜索，无需我们在模板中额外编写代码来解析URL参数。

以下是搜索结果页面展示的模板代码示例：

<div>
    {% archiveList archives with type="page" limit="10" %}
        {% for item in archives %}
        <article class="search-result-item">
            <h3><a href="{{item.Link}}">{{item.Title}}</a></h3>
            <p>{{item.Description}}</p>
            <div class="meta-info">
                <span>分类：{% categoryDetail with name="Title" id=item.CategoryId %}</span>
                <span>发布日期：{{stampToDate(item.CreatedTime, "2006-01-02")}}</span>
                <span>浏览量：{{item.Views}}</span>
            </div>
            {% if item.Thumb %}
            <div class="thumbnail">
                <a href="{{item.Link}}">
                    <img alt="{{item.Title}}" src="{{item.Thumb}}">
                </a>
            </div>
            {% endif %}
        </article>
        {% empty %}
        <div class="no-results">
            抱歉，没有找到与“{{urlParams.q}}”相关的结果。请尝试其他关键词。
        </div>
        {% endfor %}
    {% endarchiveList %}

    {# 分页导航区域 #}
    <nav class="pagination-area">
        {% pagination pages with show="5" %}
            <ul>
                <li class="page-info">总计 {{pages.TotalItems}} 条结果，共 {{pages.TotalPages}} 页</li>
                <li><a class="{% if pages.FirstPage.IsCurrent %}active{% endif %}" href="{{pages.FirstPage.Link}}">{{pages.FirstPage.Name}}</a></li>
                {% if pages.PrevPage %}
                <li><a href="{{pages.PrevPage.Link}}">{{pages.PrevPage.Name}}</a></li>
                {% endif %}
                {% for item in pages.Pages %}
                <li><a class="{% if item.IsCurrent %}active{% endif %}" href="{{item.Link}}">{{item.Name}}</a></li>
                {% endfor %}
                {% if pages.NextPage %}
                <li><a href="{{pages.NextPage.Link}}">{{pages.NextPage.Name}}</a></li>
                {% endif %}
                <li><a class="{% if pages.LastPage.IsCurrent %}active{% endif %}" href="{{pages.LastPage.Link}}">{{pages.LastPage.Name}}</a></li>
            </ul>
        {% endpagination %}
    </nav>
</div>

在这个模板代码中，我们做了几件重要的事情：

  1. {% archiveList archives with type="page" limit="10" %}：这行代码指示系统以分页模式获取文档列表，每页显示10条。archives是我们自定义的变量名，用于存储搜索到的文档数据。
  2. {% for item in archives %}：循环遍历每一条搜索结果。item变量代表当前文档，我们可以从中获取文档的 Title（标题）、Link（链接）、Description（描述）、Thumb（缩略图）等信息。
  3. {% empty %} 语句块：这是安企CMS模板标签的一个非常实用的功能。当 archiveList 没有找到任何符合条件的文档时，empty 块内的内容就会被显示出来，而不是一个空白页面，从而提供了友好的“无结果”提示。
  4. {% pagination pages with show="5" %}：为了让用户能够浏览多页的搜索结果，我们结合了 pagination 标签。它会根据 archiveList 标签返回的分页数据，自动生成“首页”、“上一页”、“下一页”以及中间页码的导航链接。show="5" 指定了最多显示5个页码按钮。

优化搜索体验的建议

  • 关键词保留： 如前所述，在搜索表单的 input 元素中使用 value="{{urlParams.q}}"，能让用户在搜索结果页面看到他们之前输入的关键词，方便修改或再次搜索。
  • 无结果反馈： 充分利用 archiveList 标签的 {% empty %} 块，为用户提供清晰、友好的无结果提示，并建议尝试其他关键词或浏览其他内容。
  • SEO优化： 搜索结果页面的TDK（Title、Description、Keywords）也值得关注。虽然安企CMS的TDK标签默认服务于文章、分类、单页等，但我们可以通过自定义模板或结合后台设置，让搜索结果页的TDK更具针对性，例如将搜索关键词融入页面标题中，以提升搜索引擎对搜索结果页的理解。

安企CMS的关键词搜索功能不仅易于实现，而且与内置的模板和SEO功能无缝集成，为网站访客提供了高效的内容发现途径，也为网站管理员提供了灵活的内容呈现能力，是提升