在AnQiCMS的灵活世界里，内容模型（Content Model）的自定义参数（Custom Parameters）为网站运营者提供了极大的自由度，让我们能够突破传统标题、内容、简介的限制，为不同类型的文档（如文章、产品、案例等）添加个性化的数据字段。例如，一个产品详情页可能需要展示“产品型号”、“颜色选项”、“材质”等信息，而一篇技术文章则可能需要“作者”、“发布日期”、“参考资料”等字段。

那么，当我们在后台为这些文档精心配置了自定义参数后，如何在前端模板中将它们优雅地展示出来，尤其是需要循环遍历并显示每个参数的Name（名称）和Value（值）呢？安企CMS为此提供了专门的archiveParams标签，它就像一座桥梁，将后台的灵活配置与前端的动态展示完美连接。

安企CMS中的自定义参数：丰富内容的基石

在深入archiveParams标签之前，我们先简要回顾一下自定义参数在AnQiCMS中的定位。当你创建一个新的内容模型（比如“产品模型”）时，除了系统预设的字段，你还可以根据业务需求添加专属的自定义字段。这些字段可以是单行文本、数字、多行文本、单项选择、多项选择或下拉选择等多种类型。一旦定义好，你在发布“产品”类型的文档时，就可以为这些自定义字段填写具体的值。正是这些灵活的自定义参数，让AnQiCMS能够轻松应对各种复杂的网站内容结构。

archiveParams标签：解锁自定义参数的显示力量

archiveParams标签正是为了方便地获取和展示这些绑定在特定文档上的自定义参数而设计的。它的核心功能是允许你循环遍历一个文档的所有自定义参数，并提取它们的名称（Name）和对应的值（Value）。

我们来看它的基本用法：

{% archiveParams params %}
    {% for item in params %}
        <p><strong>{{ item.Name }}：</strong> {{ item.Value }}</p>
    {% empty %}
        <p>该文档暂无自定义参数信息。</p>
    {% endfor %}
{% endarchiveParams %}

在这段代码中：

  • {% archiveParams params %}：我们声明了一个名为 params 的变量，它将承载当前文档（默认情况下，如果未指定id参数，则为当前详情页的文档）的所有自定义参数集合。
  • {% for item in params %}：这行代码启动了一个循环，item 变量在每一次迭代中代表一个独立的自定义参数。
  • {{ item.Name }}：在循环内部，通过 item.Name 我们可以获取到当前自定义参数在后台配置时所设置的“参数名”（例如“产品型号”、“颜色”）。
  • {{ item.Value }}：而 item.Value 则会显示你在后台为该参数填写的具体“参数值”（例如“骁龙888”、“黑色”）。
  • {% empty %}：这是一个非常贴心的特性，如果当前文档没有任何自定义参数，或者 params 变量为空，那么就会显示 empty 块中的内容，避免页面出现空白或错误。

标签参数详解：更精细的控制

archiveParams标签还提供了一些参数，让我们能够更精细地控制其行为：

  • id：默认情况下，archiveParams会自动获取当前文档页面的自定义参数。但如果你需要获取指定文档的参数，可以通过id="文档ID"来明确指定。例如：{% archiveParams params with id="123" %} 将获取ID为123的文档的参数。
  • sorted：这个参数决定了params变量返回的数据结构。
    • sorted=true（默认值）：params会是一个按后台定义的顺序排列的数组对象。在这种情况下，你可以像上面示例那样使用 for 循环遍历 item.Name 和 item.Value，这也是我们最常使用的场景。
    • sorted=false：params会是一个无序的map（键值对）对象。此时，如果你知道自定义参数的“调用字段”（在内容模型中定义的英文名称，如processor），你可以直接通过 {{ params.processor.Name }} 和 {{ params.processor.Value }} 来访问特定参数，但这种方式就无法直接进行简单的循环遍历了。
  • siteId：如果你启用了AnQiCMS的多站点管理功能，并需要调用其他站点的数据，可以通过siteId="站点ID"来指定。

实战演练：为产品详情页构建参数列表

假设我们正在为一个销售电子产品的网站构建产品详情页，并且在后台的产品模型中定义了“处理器(processor)”、“内存(memory)”、“存储(storage)”、“屏幕尺寸(screenSize)”等自定义参数。现在，我们希望在产品详情页的一个侧边栏或专门的区域展示这些参数。

以下是模板中的实现示例：

<div class="product-specifications-section">
    <h4 class="section-title">产品技术参数</h4>
    <ul class="spec-list">
        {% archiveParams productSpecs %}
            {% for spec in productSpecs %}
                <li class="spec-item">
                    <span class="spec-name">{{ spec.Name }}：</span>
                    <span class="spec-value">{{ spec.Value }}</span>
                </li>
            {% empty %}
                <li class="no-specs-info">该产品暂未提供详细技术参数。</li>
            {% endfor %}
        {% endarchiveParams %}
    </ul>
</div>

通过这段简洁的代码，无论你在后台为产品添加了多少自定义参数，只要它们被正确填写，前端页面都能够自动、动态地将它们的名称和值一一列出。这不仅大大提高了内容管理的效率，也让网站内容展示更加灵活和富有层次感。

优化与注意事项

在实际应用archiveParams标签时，有几点值得注意：

  • 前端样式是关键： 标签本身只负责输出数据，如何让这些参数美观、易读地呈现给用户，还需要依赖CSS样式。例如，你可以为product-specifications-section、spec-list、spec-item等添加相应的样式。
  • 后台规划先行： 良好的前端展示离不开清晰的后台规划。在定义自定义参数时，尽量使用直观的“参数名”和有意义的“调用字段”，这将使得模板编写和内容管理都更加便捷。
  • 利用 {% empty %}： 总是使用empty块来处理没有自定义参数的情况，这能有效提升用户体验，避免页面内容缺失的尴尬。

通过archiveParams标签，AnQiCMS让自定义参数的展示变得轻而易举，无论是构建复杂的产品列表还是丰富的文章详情页，