如何在AnQiCMS模板中使用条件判断（if/else）标签控制内容的显示逻辑？

在网站模板的开发和维护中，我们经常会遇到需要根据特定条件来显示或隐藏不同内容的需求。这种动态的内容展示逻辑，对于提升用户体验、实现个性化功能以及优化网站结构都至关重要。安企CMS（AnQiCMS）作为一款功能强大的内容管理系统，提供了灵活的模板引擎，其中条件判断（if/else）标签是实现这一目标的核心工具。

安企CMS的模板引擎语法类似Django，它允许开发者使用简洁直观的标签来控制页面内容的生成。通过巧妙地运用条件判断，我们可以让网站内容更智能、更贴合用户的实际访问情境。

掌握基本的条件判断语法

在安企CMS模板中，条件判断标签以 {% if ... %} 开始，并以 {% endif %} 结束。这是最基础的用法，当括号内的条件成立（即为真）时，其内部的内容就会被显示；反之则不会。

例如，我们可能需要检查某个变量是否存在或是否为空。假设我们正在显示一篇文章详情，并希望只有当文章标题存在时才展示它：

{% if archive.Title %}
    <h1>{{ archive.Title }}</h1>
{% endif %}

这里，archive.Title 代表文章的标题。如果文章标题有值，这个 <h1> 标签和标题内容就会出现在页面上；如果标题为空，那么整个 <h1> 标签连同其内容都不会渲染出来。

引入“否则”的分支：if-else

很多时候，当一个条件不满足时，我们需要提供一个替代方案来显示不同的内容。这时，else 标签就派上了用场。它与 if 标签搭配使用，形成一个二选一的逻辑分支：

{% if archive.Thumb %}
    <img src="{{ archive.Thumb }}" alt="{{ archive.Title }}">
{% else %}
    <img src="/static/images/default-thumb.jpg" alt="默认缩略图">
{% endif %}

在这个例子中，如果文章有缩略图 (archive.Thumb)，就显示文章自身的缩略图；如果没有，则显示一张预设的默认缩略图。这确保了页面布局的完整性，避免因缺少图片而导致的空白或样式问题。

处理多个条件：if-elif-else

当我们需要处理的条件不止两个，而是有多个互斥情况时，elif（else if 的缩写）标签便显得尤为重要。它允许我们按顺序检查一系列条件，直到找到第一个满足的条件并执行其对应的代码块。如果所有 if 和 elif 条件都不满足，最后的 else 块（如果存在）将作为默认情况被执行。

例如，在文章列表中，我们可能希望根据文章的“推荐属性”（Flag）来显示不同的标记：

{% if item.Flag == 'h' %}
    <span class="flag-hot">热点</span>
{% elif item.Flag == 'c' %}
    <span class="flag-recommend">推荐</span>
{% elif item.Flag == 'f' %}
    <span class="flag-slide">幻灯</span>
{% else %}
    <!-- 其他文章不显示特殊标记 -->
{% endif %}

这里，item.Flag 表示文章的推荐属性（如来自 archiveList 标签获取的文章列表项）。系统会依次检查文章是否为热点、推荐或幻灯，并显示对应的标签。如果都不是，则不显示任何特殊标记。

灵活运用条件判断的实践场景

条件判断的强大之处在于它能够与安企CMS提供的各种标签和数据模型深度结合，实现极其灵活的内容控制。

  • 列表内容为空时的提示： 当使用 archiveList 或 categoryList 等标签获取数据列表时，如果列表为空，我们可以通过 if 语句判断列表变量的长度来显示“暂无内容”的提示，而不是直接留白。例如，{% if archives|length > 0 %} 然后遍历列表，{% else %} <div>暂无相关文章</div> {% endif %}。

  • 导航菜单的当前选中状态： 在构建导航菜单时，navList 标签返回的 item.IsCurrent 属性非常有用。我们可以用它来判断当前导航项是否是用户正在访问的页面，并为其添加一个 active 类，以突出显示：

    <li {% if item.IsCurrent %}class="active"{% endif %}>
    <a href="{{ item.Link }}">{{ item.Title }}</a>
</li>

  • 根据系统设置控制功能显示： 安企CMS的 system 标签可以获取网站的全局配置信息。例如，我们可以判断网站是否处于关闭状态，并显示相应的提示页面：

    {% system siteStatus with name="SiteStatus" %}
{% if siteStatus == 0 %} {# 假设0代表关闭状态 #}
    {% system closeTips with name="SiteCloseTips" %}
    <div class="site-closed-message">
        {{ closeTips|safe }}
    </div>
{% else %}
    <!-- 正常网站内容 -->
{% endif %}

    这里需要注意，文档help-setting-system.md中网站状态的说明为当你选择为闭站状态下，用户将只会看到闭站提示信息。，这说明闭站逻辑已经在系统层面处理，模板层面可能更多用于判断其他自定义系统参数。

  • 自定义字段的个性化展示： 通过 archiveDetail 或 categoryDetail 获取的自定义字段，可以根据其是否存在或特定值来决定如何展示。例如，如果产品模型有一个自定义字段叫 Price：

    {% archiveDetail productPrice with name="Price" %}
{% if productPrice and productPrice > 0 %}
    <p>价格: {{ productPrice }} 元</p>
{% else %}
    <p>价格: 询价</p>
{% endif %}

  • 处理分页链接的可用性： 在 pagination 标签返回的分页对象中，pages.PrevPage 和 pages.NextPage 可以用来判断是否存在上一页或下一页，从而决定是否显示对应的导航按钮。

    {% if pages.PrevPage %}
    <a href="{{ pages.PrevPage.Link }}">上一页</a>
{% else %}
    <span class="disabled">上一页</span>
{% endif %}

撰写条件判断时的注意事项

在编写条件判断时，有几个小技巧可以帮助我们写出更清晰、更高效的代码：

  1. 明确结束标签： 每一个 {% if %} 都必须有对应的 {% endif %}。如果使用了 elif 或 else，它们必须在 if 和 endif 之间。
  2. 使用逻辑运算符： 可以使用 and、or、not 等逻辑运算符来组合更复杂的条件，例如 {% if user.IsLoggedIn and user.IsAdmin %}。
  3. 变量存在性判断： 简单地将变量名放入 if 语句中，就可以判断该变量是否存在且不为空（对于字符串、数字、列表等）。例如，{% if archive.Content %} 就会在 archive.Content 非空时为真。
  4. 精确的比较： 可以使用 ==（等于）、!=（不等于）、<（小于）、>（大于）、<=（小于等于）、>=（大于等于）等比较运算符。
  5. 去除多余空白： 在条件标签内部使用 {%- 或 -%} 可以去除标签所在行前或后的空白字符，这对于生成整洁的HTML代码非常有用，尤其是在循环或条件语句可能引入额外换行符时。例如：{%- if condition -%}。

通过灵活运用安企CMS模板中的条件判断标签，我们能够创建出响应式强、功能丰富且内容展示更具智能化的网站。这不仅提升了网站的专业度，也为访问者带来了更优质的浏览体验。

常见问题 (FAQ)

1. 我可以在条件判断中使用哪些类型的运算符？

您可以在安企CMS的条件判断中使用多种运算符。除了前面提到的相等（==）、不相等（!=）、大于（>）、小于（<）等比较运算符外，您还可以使用逻辑运算符，如 and（逻辑与）、or（逻辑或）和 not（逻辑非），来组合或否定条件。例如，{% if item.Views > 100 and item.Flag == 'h' %}。此外，您甚至可以在条件判断中进行简单的算术运算，例如 {% if item.Price * item.Quantity > 500 %}。

2. 如何在循环中根据条件给不同的项目应用不同的样式？

在 for 循环中，您可以使用条件判断结合循环变量的属性来动态应用样式。例如，forloop.Counter 可以获取当前循环的索引（从1开始），forloop.Revcounter 可以获取剩余的循环次数。您可以这样给循环中的第一个项目添加一个 active 类：

{% for item in archives %}
    <div class="list-item {% if forloop.Counter == 1 %}active{% endif %}">
        {{ item.Title }}
    </div>
{% endfor %}

您还可以结合数据本身的属性（例如 item.IsCurrent 或 item.Status）来判断，根据不同的值应用不同的CSS类名。

3. 如果条件判断中引用的变量不存在或为空，会发生什么？

在安企CMS模板中，当您在 if 语句中直接引用一个不存在的变量或者一个存在但其值为空（例如空字符串、数字0、nil、空列表或空对象）的变量时，该条件会被评估为假（false）。这通常是一个方便的特性，因为它允许您安全地检查数据是否存在，而不会导致模板渲染错误。例如，{% if archive.Author %} 仅