如何在文档列表页实现多条件（如自定义参数）的筛选功能？
在安企CMS中，为文档列表页实现多条件筛选功能，特别是基于自定义参数的筛选，是提升用户体验、帮助用户快速找到所需内容的关键。安企CMS凭借其灵活的内容模型和强大的模板标签系统，让这一功能实现起来既高效又直观。
整个过程可以分为几个核心步骤：首先，在后台定义好你的内容模型和自定义筛选字段；其次，在模板中构建筛选条件的展示界面；最后，利用列表标签将筛选结果呈现在文档列表中。
一、准备工作：定义内容模型与自定义字段
要实现基于自定义参数的筛选，我们首先需要确保内容本身就包含了这些可供筛选的参数。安企CMS提供了灵活的内容模型管理功能，允许用户根据业务需求自定义字段。
进入内容模型管理：登录安企CMS后台，导航至“内容管理” -> “内容模型”。这里，你可以选择修改现有的内容模型（如“文章模型”或“产品模型”），或者创建一个全新的模型。
添加自定义字段：在内容模型的编辑页面，找到“内容模型自定义字段”区域。点击添加字段，你需要配置以下几个关键项：
- 参数名：这是字段的显示名称，例如“房屋类型”、“所在区域”或“价格区间”。
- 调用字段：这是模板中用来调用该字段的唯一标识，通常建议使用英文字母，如
houseType、region、priceRange。这个字段名将直接用于URL查询参数。 - 字段类型：这一点至关重要。为了方便筛选，我们通常会选择“单项选择”、“多项选择”或“下拉选择”这几种类型。这些类型能够提供预设的选项，从而生成规范化的筛选条件。
- 默认值：如果选择了“单项选择”、“多项选择”或“下拉选择”类型，就需要在这里填写选项值。每个选项占一行，系统会自动将其解析为独立的筛选项目。例如，在“房屋类型”字段中，你可以填写“住宅”、“商铺”、“别墅”等。
- 是否必填：根据你的业务需求设置。
通过以上步骤，你就为内容模型添加了具备筛选潜力的自定义参数。例如，为房产模型添加“户型”（单选，选项：一居室、两居室、三居室）和“装修”（单选，选项：精装修、毛坯、简装修）等字段。
二、核心功能：构建筛选条件展示界面
自定义参数定义完成后，接下来需要在前端页面上展示这些筛选条件，供用户选择。这主要通过安企CMS提供的 archiveFilters 标签来完成。
选择合适的模板文件：通常，文档列表页对应的模板文件是
{模型table}/list.html或{模型table}/list-{文档分类ID}.html。在该文件中，你需要插入筛选条件的模板代码。使用
archiveFilters标签：archiveFilters标签专门用于生成基于模型自定义参数的筛选条件列表。它会遍历你为指定模型定义的、适合筛选的自定义字段，并为每个字段的选项生成相应的筛选链接。它支持以下参数：
moduleId：指定要筛选的内容模型ID。例如，moduleId="1"表示文章模型，moduleId="2"表示产品模型。如果当前页面本身就是某个模型的列表页，这个参数可以省略，系统会自动识别。allText：用于设置每个筛选条件项的“全部”选项的显示文本，例如“不限”、“所有”等。如果不想显示，可以设置为false。
archiveFilters标签会返回一个包含所有筛选字段及其选项的数组对象。每个字段对象包含Name(参数名)、FieldName(调用字段) 以及Items(该字段的所有选项)。Items数组中的每个选项又包含Label(选项显示文本)、Link(筛选链接) 和IsCurrent(是否当前选中) 等信息。构建筛选界面示例：以下是一个典型的筛选界面代码结构：
<div class="filter-area"> {% archiveFilters filters with moduleId="1" allText="不限" %} {% for item in filters %} <ul class="filter-group"> <li class="filter-name">{{ item.Name }}:</li> {% for val in item.Items %} <li class="filter-item {% if val.IsCurrent %}active{% endif %}"> <a href="{{ val.Link }}">{{ val.Label }}</a> </li> {% endfor %} </ul> {% endfor %} {% endarchiveFilters %} </div>这段代码会遍历所有可筛选的自定义字段，为每个字段（如“户型”、“装修”）生成一个
<ul>列表，并在其中展示该字段的所有选项。每个选项都会生成一个链接，点击后会带上相应的查询参数跳转到当前列表页，同时IsCurrent属性会帮助我们为当前选中的筛选条件添加active类，实现高亮显示。
三、联动展示：让筛选结果在文档列表中生效
当用户点击筛选链接后，URL中会带上形如 ?houseType=三居室&decoration=精装修 的查询参数。这时，文档列表需要能够识别并响应这些参数，只显示符合条件的文档。
使用
archiveList标签：在文档列表页，我们使用archiveList标签来获取和显示文档数据。关键在于设置type="page"参数，这样archiveList标签就能够自动解析URL中的查询参数，并将其作为筛选条件应用到文档查询中。archiveList标签支持多种参数，其中最重要的是：type="page"：告诉标签这是一个需要分页的列表，并且会自动处理URL中的筛选参数和页码。moduleId：指定要显示的文档所属模型。limit：控制每页显示的文档数量。- 其他参数如
categoryId、order、q（搜索关键词）等也可以按需配合使用。
构建文档列表示例：
<div class="document-list"> {% archiveList archives with type="page" moduleId="1" limit="10" %} {% for item in archives %} <div class="document-item"> <a href="{{ item.Link }}"> <h3>{{ item.Title }}</h3> <p>{{ item.Description }}</p> <div class="meta"> <span>分类: {% categoryDetail with name="Title" id=item.CategoryId %}</span> <span>发布日期: {{ stampToDate(item.CreatedTime, "2006-01-02") }}</span> <span>浏览量: {{ item.Views }}</span> </div> </a> </div> {% empty %} <p>没有找到符合条件的文档。</p> {% endfor %} {% endarchiveList %} </div> {# 分页导航 (需配合 type="page" 使用) #} <div class="pagination-area"> {% pagination pages with show="5" %} {# 分页逻辑代码，此处省略，可参考文档 tag-pagination.md #} <!-- 示例: 首页、上一页、页码、下一页、末页链接 --> {% endpagination %} </div>通过设置
type="page"，archiveList会自动将archiveFilters生成的、并点击后传入URL的查询参数识别为筛选条件。它会根据这些参数过滤文档，并仅显示符合条件的文档。同时，它也会将当前页码信息传递给pagination标签，实现筛选条件下的正确分页。
四、整合与优化：一个完整的筛选页面示例
将上述的筛选条件展示和文档列表展示代码整合到同一个模板文件（例如 product/list.html）中，即可形成一个功能完善的多条件筛选文档列表页。
例如，一个房产网站的列表页，用户可以选择“户型”、“区域”、“价格范围”等条件进行筛选：
”`twig {# 筛选条件展示区 #} <div class=”