在安企CMS中构建一个互动性强、内容易于查找的网站，动态搜索和筛选功能是不可或缺的。archiveList标签作为内容输出的核心工具，巧妙地结合URL查询参数，能够帮助我们实现强大的内容发现机制，让用户轻松定位到他们感兴趣的信息。
archiveList标签的核心作用
archiveList标签是安企CMS中用于获取和展示文档列表的关键。无论是文章、产品还是其他自定义内容模型，archiveList都能灵活地调用和组织它们。它提供了丰富的参数，如按分类ID、模型ID、推荐属性等来筛选内容。然而，其真正的强大之处在于，它能够与URL中的查询参数无缝协作，实现高度动态化的内容展示。
理解URL查询参数
在网页浏览中，URL（统一资源定位符）末尾常常会出现?符号，其后跟着一系列key=value的键值对，这些就是URL查询参数，例如yourdomain.com/list?category=news&tag=CMS。它们用于向服务器传递额外的信息，通常用来指示页面内容的动态变化，比如搜索关键词、筛选条件或当前页码。安企CMS的archiveList标签能够智能地解析并应用这些参数，无需额外的后端编程。
实现动态搜索
动态搜索是网站内容发现的第一步。用户在搜索框中输入关键词，点击搜索后，页面应该根据关键词展示相关内容。在安企CMS中，这可以通过archiveList标签的q参数来实现。
当用户通过一个GET方法提交的搜索表单（例如<form method="get" action="/search">）时，搜索框中name="q"的输入内容会被添加到URL中，形成如/search?q=关键词这样的查询参数。此时，您只需在搜索结果页面的模板中，使用archiveList标签并将其type属性设置为"page"（表示启用分页模式），archiveList便会自动检测URL中是否存在q参数，并根据其值进行内容筛选。
例如，在您的搜索模板（如search/index.html）中，可以这样放置archiveList标签：
{# 搜索表单 #}
<form method="get" action="/search">
<input type="text" name="q" placeholder="请输入搜索关键词" value="{{urlParams.q}}">
<button type="submit">搜索</button>
</form>
{# 动态搜索结果列表 #}
{% archiveList archives with type="page" limit="10" %}
{% for item in archives %}
<li><a href="{{item.Link}}">{{item.Title}}</a> - {{item.Description}}</li>
{% empty %}
<li>没有找到相关内容。</li>
{% endfor %}
{% endarchiveList %}
{# 分页导航 #}
{% pagination pages with show="5" %}
{# 渲染分页链接 #}
{% endpagination %}
{{urlParams.q}}的使用是一个小技巧，它能确保在用户进行新搜索或刷新页面时，搜索框中仍然显示之前输入的关键词，提升用户体验。
实现动态筛选
除了关键词搜索，动态筛选功能则允许用户根据预设的属性（如分类、自定义字段值等）来缩小内容范围。这在产品列表、案例展示等场景中尤为实用。安企CMS通过“内容模型”的概念，允许您为不同类型的内容定义自定义字段，这些字段正是动态筛选的基石。
archiveFilters标签是构建动态筛选界面的利器。它会根据指定的内容模型（moduleId）和当前页面的上下文，自动生成一系列的筛选条件及对应的URL链接。这些链接的URL中，同样会包含查询参数，例如list?property_type=apartment&area=CBD。
当用户点击archiveFilters生成的筛选链接时，页面URL会更新，archiveList标签会再次自动识别这些新增的查询参数（例如property_type=apartment），并只显示符合所有条件的内容。
一个典型的动态筛选器和列表配合使用的场景可能如下：
{# 动态筛选器界面 #}
<div>
<h3>筛选条件：</h3>
{% archiveFilters filters with moduleId="1" allText="全部" %}
{% for item in filters %}
<p>{{item.Name}}:</p>
<ul>
{% for val in item.Items %}
<li class="{% if val.IsCurrent %}active{% endif %}">
<a href="{{val.Link}}">{{val.Label}}</a>
</li>
{% endfor %}
</ul>
{% endfor %}
{% endarchiveFilters %}
</div>
{# 动态筛选结果列表 (与搜索共用同一 archiveList 标签) #}
{% archiveList archives with type="page" limit="10" %}
{% for item in archives %}
<li>
<a href="{{item.Link}}">
<h4>{{item.Title}}</h4>
<p>{{item.Description}}</p>
</a>
</li>
{% empty %}
<li>没有找到符合筛选条件的内容。</li>
{% endfor %}
{% endarchiveList %}
{# 分页导航 #}
{% pagination pages with show="5" %}
{# 渲染分页链接 #}
{% endpagination %}
在这个例子中，archiveFilters会遍历内容模型中所有可筛选的自定义字段（例如“房屋类型”、“价格区间”等），为每个选项生成一个包含相应查询参数的链接。archiveList则负责根据当前URL中可能存在的q参数（搜索关键词）以及archiveFilters生成的自定义字段参数，动态地查询并展示匹配的文档。
实战：组合搜索与筛选
将动态搜索和动态筛选结合起来，可以为用户提供极度精细的内容发现体验。想象一下，用户可以在一个页面上输入关键词搜索“安企CMS教程”，同时通过筛选器选择“文章类型：入门教程”、“发布年份：2023”，archiveList会智能地将这些条件叠加，呈现出最符合用户需求的结果。
这一切都得益于archiveList对URL查询参数的自动化处理。无论是用户直接输入URL，还是通过搜索框、筛选链接操作，archiveList都能理解并响应这些参数，确保内容展示的准确性和即时性。同时，安企CMS的伪静态功能确保了这些动态生成的URL依然保持SEO友好，便于搜索引擎收录。
通过这种方式，网站不再是静态的展示页面，而是一个能够与用户深度互动、按需提供信息的强大平台。
常见问题 (FAQ)
问：
archiveList标签是如何知道要根据哪些自定义字段进行筛选的？ 答：archiveFilters标签会读取您在后台“内容模型”中为特定模型（通过moduleId参数指定）定义的“内容模型自定义字段”。只有那些在自定义字段中设置为可筛选的字段，才会被archiveFilters识别并用于生成筛选链接。archiveList则会根据URL中与这些自定义字段FieldName匹配的查询参数自动应用筛选。问：如果我同时使用了搜索关键词（
q参数）和多个筛选条件，archiveList会如何处理？ 答：archiveList标签非常智能，它会自动将URL中所有的查询参数（包括q参数和通过archiveFilters生成的自定义字段参数）叠加起来，作为其内部查询的筛选条件。这意味着它会同时满足所有条件，返回既包含搜索关键词又符合所有筛选条件的内容。问：在动态搜索和筛选场景下，分页功能还能正常工作吗？ 答：完全可以。当`archive