在安企CMS的强大内容管理体系中，自定义参数（或称为内容模型自定义字段）是其灵活性的重要体现。它允许运营者根据特定业务需求，为文章、产品等内容模型添加标准字段之外的个性化数据。但在前端模板中，我们常常需要判断某个自定义参数是否存在或者是否被赋予了有效值，再决定是否将其展示出来。这时，archiveParams 标签就成了我们不可或缺的利器。

理解自定义参数的价值与archiveParams标签

AnQiCMS的设计哲学强调高度定制化，这其中“灵活的内容模型”是核心功能之一。这意味着你可以为不同类型的内容（如新闻文章、电商产品、服务案例）定义独特的字段，例如为产品添加“材质”、“尺寸”，为文章添加“作者简介”、“原文链接”等。这些个性化数据，就是我们所说的自定义参数。

在AnQiCMS的版本迭代中，特别是从v2.1.1开始，模板标签进行了重构，archive标签系列被引入，这使得对内容模型数据的访问更加统一和便捷。archiveParams标签便是其中专门用于获取文档（archive）自定义参数的工具。它能够将后台为当前文档或指定文档配置的所有自定义字段，以结构化的形式提供给前端模板使用。

archiveParams：自定义参数的智能侦测器

archiveParams标签能够以两种主要形式返回自定义参数：一个有序的数组或一个无序的映射（map）。理解这两种形式对于判断参数是否存在至关重要。

方法一：遍历有序数组进行判断（默认 sorted=true）

当你使用 {% archiveParams params %} 这样的方式，或者明确指定 sorted=true 时，archiveParams会返回一个包含所有自定义参数的数组。数组中的每个元素都是一个对象，包含 Name（参数的显示名称）和 Value（参数的值）两个属性。

在这种模式下，要判断某个特定自定义参数是否存在并显示其值，我们需要遍历这个数组，找到对应的参数名，并检查其 Value 是否非空。

让我们通过一个场景来具体说明：假设你为文章模型添加了一个自定义字段，名为“文章来源”，其调用字段为 articleSource。你希望在文章详情页显示这个来源，但前提是它必须有内容。

在模板中，你可以这样实现：

{# 使用 archiveParams 获取所有自定义参数，默认 sorted=true #}
{% archiveParams extraFields %}
    {# 遍历 extraFields 数组 #}
    {% for field in extraFields %}
        {# 判断当前遍历到的字段的名称是否为“文章来源”，并且其值不为空 #}
        {% if field.Name == "文章来源" and field.Value %}
            <p><strong>文章来源：</strong> {{ field.Value }}</p>
        {% endif %}
    {% endfor %}
{% endarchiveParams %}

在这段代码中：

  1. {% archiveParams extraFields %} 将当前文档的所有自定义参数存储在 extraFields 变量中。
  2. {% for field in extraFields %} 循环遍历 extraFields 数组中的每一个自定义参数。
  3. {% if field.Name == "文章来源" and field.Value %} 是关键的判断逻辑：
    • field.Name == "文章来源" 确保我们找到了目标参数。
    • field.Value 则用于判断该参数是否被赋予了实际内容。在模板语言中，空字符串、数字0、布尔值false或nil（空值）都会被评估为“假”，非常适合用于这种“是否存在有效内容”的判断。
  4. 如果条件满足，{{ field.Value }} 就会将参数内容显示出来。

方法二：直接访问无序映射进行判断（指定 sorted=false）

如果你明确知道自定义参数的“调用字段”名称（即在后台内容模型中定义的字段名，如 articleSource），并且希望更直接地访问，那么可以将 sorted 参数设置为 false。

{% archiveParams params with sorted=false %} 会返回一个映射（map）对象，你可以通过调用字段名直接访问参数的属性，例如 params.articleSource.Value。

沿用上一个“文章来源”的例子，如果其调用字段是 articleSource，你可以这样判断和显示：

{# 使用 archiveParams 获取所有自定义参数，指定 sorted=false 返回映射 #}
{% archiveParams extraFields with sorted=false %}
    {# 直接通过调用字段名访问，并判断其值是否存在 #}
    {% if extraFields.articleSource.Value %}
        <p><strong>文章来源：</strong> {{ extraFields.articleSource.Value }}</p>
    {% endif %}
{% endarchiveParams %}

这种方式更加简洁，当你确切知道要访问哪个自定义参数时，可以省去循环遍历的步骤。同样地，extraFields.articleSource.Value 的值是否非空是判断其存在性的核心。

另一种直接访问的思路：archiveDetail 标签

除了 archiveParams 之外，如果你仅仅是想获取某个特定、已知调用字段的自定义参数值，也可以考虑使用 archiveDetail 标签。这个标签通常用于获取文档的内置字段（如 Title、Content），但它也支持直接获取自定义参数的值。

例如，要获取并判断“文章来源”是否存在，可以这样写：

{# 使用 archiveDetail 直接获取“文章来源”字段的值 #}
{% archiveDetail sourceValue with name="articleSource" %}
    {# 判断获取到的值是否非空 #}
    {% if sourceValue %}
        <p><strong>文章来源：</strong> {{ sourceValue }}</p>
    {% endif %}
{% endarchiveDetail %}

这种方法在只需要获取少数几个已知自定义参数时，显得尤为直接和方便。

总结

无论是通过 archiveParams 标签的遍历数组模式，直接映射访问模式，还是 archiveDetail 标签的直接获取，AnQiCMS 都提供了灵活的方式来处理自定义参数。核心在于利用模板语言的条件判断（if 标签），检查参数的 Value 属性是否包含有效内容。这不仅能让你的网站内容展示更加精准，也能有效避免因数据缺失导致的页面布局混乱或信息错误。掌握这些技巧，你将能够更自如地运用AnQiCMS构建功能丰富、信息完善的网站。

常见问题 (FAQ)

  1. Q: 为什么我设置了自定义参数，但在模板中却无法显示，甚至连循环都找不到？ A: 首先，请确保你的自定义字段在后台内容模型中已正确创建并保存，并且文档在发布时确实为该字段填充了内容。其次，检查你在模板中使用 archiveParams 或 archiveDetail 标签时，id 参数是否正确指向了包含该自定义参数的文档ID（如果未指定id，则默认为当前页面的文档）。最后，核对标签中 name 参数的值或在 sorted=false 模式下访问的字段名是否与后台内容模型中定义的“调用字段”完全一致（区分大小写）。如果仍然无法显示，可能是该参数的值为空，导致 if 条件未通过。

  2. **Q: archiveParams 和