文档列表页面如何实现按关键词搜索和显示结果？
在日益庞大的网站内容面前，如何帮助访客快速精准地找到所需信息，是提升用户体验和网站价值的关键。安企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>
在这个模板代码中，我们做了几件重要的事情：
{% archiveList archives with type="page" limit="10" %}：这行代码指示系统以分页模式获取文档列表，每页显示10条。archives是我们自定义的变量名，用于存储搜索到的文档数据。{% for item in archives %}：循环遍历每一条搜索结果。item变量代表当前文档，我们可以从中获取文档的Title（标题）、Link（链接）、Description（描述）、Thumb（缩略图）等信息。{% empty %}语句块：这是安企CMS模板标签的一个非常实用的功能。当archiveList没有找到任何符合条件的文档时，empty块内的内容就会被显示出来，而不是一个空白页面，从而提供了友好的“无结果”提示。{% 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功能无缝集成，为网站访客提供了高效的内容发现途径，也为网站管理员提供了灵活的内容呈现能力，是提升