在AnQiCMS的丰富功能宝库中，内容模型与自定义文档参数无疑是其灵活性和强大扩展性的基石。作为一位网站运营专家，我深知如何高效、精准地在模板中调用这些自定义参数，对于实现个性化内容展示和优化运营效率至关重要。今天，我们就来深入探讨AnQiCMS模板中一个强大且常被忽略的技巧：如何单独调用archiveParams标签，以获取特定名称的自定义文档参数。
一、引言：解密AnQiCMS自定义文档参数的价值
AnQiCMS之所以能成为众多中小企业和内容运营团队的首选，很大程度上得益于其高度可定制的内容模型。通过自定义字段，我们可以为文章、产品或其他任何内容类型添加独特的属性，比如为产品添加“颜色”、“尺寸”、“材质”，或者为文章添加“作者简介”、“原文链接”等。这些自定义参数让我们的内容不再局限于固定的字段，而是能够根据业务需求千变万化，极大地丰富了信息展示的维度。
在AnQiCMS的模板系统中，archiveParams标签扮演着一个核心角色，它专门用于从文档中提取这些自定义参数。通常，我们会通过循环遍历的方式来展示所有参数，但这在某些场景下，如果我们只想获取某个特定名称的参数值，再进行其他操作，传统的循环方式就显得不够直接。幸运的是，archiveParams标签提供了更为精细的控制方式，让我们能够像访问对象属性一样，直接获取特定自定义参数。
二、archiveParams标签的核心机制与两种调用模式
archiveParams标签是AnQiCMS模板中用于获取当前文档（或指定文档）所有自定义参数的标签。要理解如何单独调用特定名称的参数，我们首先需要了解其两种主要的数据获取模式：
默认模式（
sorted=true）： 这是archiveParams标签的默认行为。当不指定sorted参数或将其设置为true时，它会返回一个有序的数组对象。这个数组中的每个元素都代表一个自定义参数，包含Name（参数名，如“产品颜色”）和Value（参数值，如“红色”）。这种模式非常适合于循环展示所有自定义参数，比如在一个产品详情页中列出所有规格。无序Map模式（
sorted=false）： 这是我们今天讨论的重点。当archiveParams标签设置sorted=false时，它将不再返回一个有序数组，而是一个无序的Map（可以理解为键值对集合）。这个Map的“键”（key）正是我们在后台内容模型中为自定义字段定义的“调用字段”名称（通常是英文小写驼峰或下划线命名），而“值”（value）则是一个对象，其中包含该自定义参数的Name和Value。在后台内容模型中，当我们为某个模型（如“产品模型”）添加自定义字段时，会要求填写“参数名”（如“产品颜色”）和“调用字段”（如
productColor）。这个“调用字段”就是我们在无序Map模式下直接访问特定参数的关键标识符。
三、精准出击：单独调用特定名称的自定义文档参数
现在，我们聚焦于如何利用archiveParams标签的无序Map模式，实现对特定名称自定义参数的精准调用。
核心策略：利用sorted=false参数
当我们将archiveParams标签的sorted参数设置为false时，其内部返回的数据结构会变成一个Map。这意味着我们可以像访问JavaScript对象属性一样，通过点语法来直接访问Map中的元素。
代码实践：一步步实现
让我们通过一个具体的例子来演示。
第一步：假设后台配置 我们以“产品模型”为例，假设在AnQiCMS后台的内容模型中，我们为产品添加了以下几个自定义字段：
- 参数名: “产品颜色”，调用字段:
productColor - 参数名: “产品材质”，调用字段:
productMaterial - 参数名: “适用场景”，调用字段:
applicationScene
第二步：模板调用示例
现在，在产品详情页的模板（例如product/detail.html）中，如果我们只想获取“产品颜色”和“适用场景”这两个特定参数的值，而不需要遍历所有参数，我们可以这样编写模板代码：
{# 在产品详情页模板中调用，假设当前文档就是产品 #}
{% archiveParams productDetails with sorted=false %}
<div class="product-specs">
{% if productDetails.productColor %} {# 建议进行if判断，确保字段存在 #}
<p><strong>产品颜色：</strong> {{ productDetails.productColor.Value }}</p>
{% endif %}
{% if productDetails.applicationScene %} {# 同上，判断字段是否存在 #}
<p><strong>适用场景：</strong> {{ productDetails.applicationScene.Value }}</p>
{% endif %}
{# 如果需要获取参数名本身，也可以这样： #}
{# <p>{{ productDetails.productColor.Name }}： {{ productDetails.productColor.Value }}</p> #}
</div>
{% endarchiveParams %}
在这段代码中：
- 我们首先使用
{% archiveParams productDetails with sorted=false %}来获取所有自定义参数，并将其存储在一个名为productDetails的Map变量中。 - 接着，通过
productDetails.productColor.Value和productDetails.applicationScene.Value这样的点语法，我们直接定位并提取了“产品颜色”和“适用场景”的参数值。 {% if ... %}判断是良好的实践，可以避免当某个自定义字段在某些文档中不存在时，导致模板渲染出现不必要的空行或错误。
与archiveDetail标签的区别和优势
你可能会注意到，archiveDetail标签也能直接获取单个自定义字段值，例如：{% archiveDetail with name="productColor" %}。这种方式确实更简洁，尤其当你只需要获取一个特定字段的值时。
然而，archiveParams（`sorted