在AnQiCMS模板开发过程中，我们经常会遇到需要根据特定条件来调整内容展示或应用不同样式的情况。例如，当列表中的某个数字满足某种规律，比如能被3整除时，我们就希望它能有特殊的表现。幸运的是，AnQiCMS强大的模板引擎提供了简单而高效的方法来实现这一需求。本文将深入探讨如何在AnQiCMS模板中灵活地判断一个数字是否能被另一个数字整除，并结合实际场景为您提供实用的代码示例。

核心功能：divisibleby 过滤器

AnQiCMS的模板语法借鉴了Django模板引擎，其中包含丰富的内置过滤器（Filter），divisibleby便是其中一个专门用于判断整除关系的过滤器。它的作用非常直观：检查一个数字（或可以转换为数字的字符串）是否能够被另一个指定数字整除。如果可以整除，它会返回True；否则，返回False。

基本用法

使用divisibleby过滤器的语法非常简洁，通常是这样呈现的：{{ 被检查的数字 | divisibleby: 整除数 }}。

比如，想要判断数字21能否被3整除，您可以这样写：

{{ 21 | divisibleby: 3 }}

这将输出True。

如果您想判断数字22能否被3整除，则可以这样写：

{{ 22 | divisibleby: 3 }}

这将输出False。

实际应用场景与组合使用

单一的divisibleby过滤器本身就会返回布尔值，但在实际模板开发中，我们通常会结合逻辑判断标签（如{% if %}）或循环标签（如{% for %}）来发挥其真正的作用。

结合 if 标签进行条件判断

最常见的场景是，根据整除结果来决定是否显示某段内容或应用某种样式。例如，您希望每当一个商品的价格是100的倍数时，显示一个“特惠”标签，就可以这样构建逻辑：

{% if product.Price | divisibleby: 100 %}
  <span>特惠商品！</span>
{% endif %}

这里的product.Price可以是一个从后台传入的商品价格变量。

在循环中应用，实现列表元素的动态样式

设想您有一个文章列表，希望每隔几行就对文章的背景色进行切换，或者每逢第N篇文章就添加一个特殊的分割线。这时候，divisibleby过滤器与循环计数器（forloop.Counter）的结合就显得尤为强大。

AnQiCMS模板中的forloop.Counter变量可以在for循环中使用，它代表当前循环的次数，从1开始计数。利用这个计数器，我们就可以轻松实现基于整除关系的动态样式。

例如，要实现一个文章列表，其中每隔3篇文章就高亮显示其背景的效果，您可以这样操作：

<ul class="article-list">
    {% for item in archives %}
        <li class="article-item {% if forloop.Counter | divisibleby: 3 %}highlight{% endif %}">
            <h3>{{ item.Title }}</h3>
            <p>{{ item.Description }}</p>
        </li>
    {% endfor %}
</ul>

通过这样的方式，当forloop.Counter能被3整除时，<li>元素就会获得highlight类名，从而应用预设的高亮样式。

数字的来源

用于divisibleby过滤器检查的数字可以来源于多种途径，可以是模板中直接写入的硬编码数字，可以是后端传递过来的变量（如archive.Id、item.Views），甚至可以是用户在后台自定义的字段值。重要的是，只要该值能够被模板引擎识别并转换为数字进行计算，divisibleby过滤器就能正常工作。

实用代码示例

下面是一些具体的代码示例，演示了divisibleby过滤器的多种应用方式。

示例一：判断数字奇偶性（基础应用）

判断一个数字是奇数还是偶数，是整除判断最简单的应用之一。

{% set myNumber = 15 %}

<p>数字 {{ myNumber }} 是
{% if myNumber | divisibleby: 2 %}
  偶数。
{% else %}
  奇数。
{% endif %}
</p>

示例二：在列表中实现隔行换色（循环应用）

假设您有一个新闻列表，希望每偶数行的新闻标题显示为蓝色。

<style>
    .news-item.even-row h3 { color: blue; }
</style>

<div class="news-section">
    {% archiveList newsArticles with type="list" limit="10" %}
        {% for article in newsArticles %}
            <div class="news-item {% if forloop.Counter | divisibleby: 2 %}even-row{% endif %}">
                <h3><a href="{{ article.Link }}">{{ article.Title }}</a></h3>
                <p>{{ article.Description | truncatechars: 100 }}</p>
            </div>
        {% endfor %}
    {% endarchiveList %}
</div>

在这个例子中，forloop.Counter用于获取当前循环的索引，当索引是偶数时，为div添加even-row类。

示例三：检查自定义字段的值是否可整除

如果您的AnQiCMS内容模型中有一个名为product_code的自定义字段，并且您想判断这个产品代码的数字部分是否能被特定数字整除。假设product_code存储的是纯数字。

{% archiveDetail productDetail with name="product_code" %}

<p>产品代码：{{ productDetail }}</p>

{% if productDetail | integer | divisibleby: 7 %}
  <p>这个产品代码是幸运数字！</p>
{% else %}
  <p>这个产品代码并非幸运数字。</p>
{% endif %}

这里我们首先通过|integer过滤器确保productDetail被当作整数处理，再进行整除判断。

注意事项

在使用divisibleby过滤器时，有几个小点需要您留意：

  • 数据类型： 过滤器会尝试将输入的“被检查的数字”和“整除数”转换为数字类型进行计算。这意味着即使您传入的是字符串形式的数字（如"21"），它通常也能正常工作。但为了确保代码的健壮性，尽可能传入实际的数字类型变量是更好的实践。如果传入的值无法转换为数字，可能会导致意外的行为或模板渲染错误。
  • 语法准确： 过滤器名称divisibleby是固定且区分大小写的，其后的冒号以及整除数也不可省略。
  • 与其他过滤器的组合： 如果您的数字需要先经过其他处理（例如从浮点数转为整数），可以先使用其他过滤器（如|integer或|float）再链式调用divisibleby，以确保计算的准确性。例如{{ myFloatNumber | integer | divisibleby: 5 }}。

通过