在构建网站时，我们经常会遇到需要根据某个数量值来动态显示文本的情况。例如，当有“1 条评论”时，我们希望显示为单数形式；而当有“2 条评论”时，则显示为复数形式。这种细节的处理不仅能提升用户体验，也展现了网站内容的专业性。如果手动判断数量并编写 if/else 逻辑，会使模板代码变得冗长且难以维护。

AnQiCMS 为模板开发者提供了一个非常实用的内置过滤器——pluralize，它能帮助我们优雅地处理单词的单数和复数形式，让您的网站内容更加自然和准确。

AnQiCMS 的解决方案：pluralize 过滤器

pluralize 过滤器是 AnQiCMS 模板引擎中的一个强大工具，它的主要作用是根据所传入的数量值，自动在单词词根后面添加正确的单数或复数后缀。这个过滤器会智能判断数量是 1（单数）还是非 1（复数），并根据您的配置选择合适的后缀。

pluralize 过滤器的基本使用格式是：{{ 数量值|pluralize:"单数后缀,复数后缀" }}。其中：

  • 数量值：这是一个动态的数字，它会决定最终输出的是单数还是复数。
  • "单数后缀,复数后缀"：这是一个可选的参数。您可以根据单词的复数规则，提供不同的后缀。

接下来，我们通过具体的例子来了解它的各种用法。

1. 默认用法（自动添加 ’s’）

对于大多数英语单词，复数形式通常是在词根后加 ’s’。pluralize 过滤器在不提供任何后缀参数时，会自动遵循这一规则：当数量是 1 时不添加任何后缀；当数量不是 1 时，添加 ’s’。

示例： 显示“X item”或“X items” 假设您有一个变量 itemCount 存储了物品的数量。

{# 假设 itemCount = 1 #}
您有 {{ itemCount }} item{{ itemCount|pluralize }}。
{# 输出：您有 1 item。 #}

{# 假设 itemCount = 5 #}
您有 {{ itemCount }} item{{ itemCount|pluralize }}。
{# 输出：您有 5 items。 #}

2. 自定义复数后缀（例如 ‘es’）

有些单词的复数形式并非简单地加 ’s’，例如以 ’s’, ‘x’, ‘ch’, ‘sh’ 结尾的单词，通常需要加 ‘es’。此时，您可以通过为 pluralize 过滤器提供一个参数来指定复数后缀。

示例： 显示“X walrus”或“X walruses” 假设您有一个变量 walrusCount 存储了海象的数量。

{# 假设 walrusCount = 1 #}
页面中有 {{ walrusCount }} walrus{{ walrusCount|pluralize:"es" }}。
{# 输出：页面中有 1 walrus。 #}

{# 假设 walrusCount = 3 #}
页面中有 {{ walrusCount }} walrus{{ walrusCount|pluralize:"es" }}。
{# 输出：页面中有 3 walruses。 #}

请注意，当只提供一个后缀参数时（例如 "es"），AnQiCMS 会将其作为复数后缀。当数量为 1 时，不会添加任何后缀。

3. 自定义单数和复数后缀（例如 ‘y,ies’）

对于以 ‘y’ 结尾的单词，变复数时通常会将 ‘y’ 改为 ‘ies’。在这种情况下，您可以为 pluralize 过滤器提供两个由逗号分隔的参数：第一个是单数后缀，第二个是复数后缀。

示例： 显示“X cherry”或“X cherries” 假设您有一个变量 cherryCount 存储了樱桃的数量。

{# 假设 cherryCount = 1 #}
库存有 {{ cherryCount }} cherr{{ cherryCount|pluralize:"y,ies" }}。
{# 输出：库存有 1 cherry。 #}

{# 假设 cherryCount = 4 #}
库存有 {{ cherryCount }} cherr{{ cherryCount|pluralize:"y,ies" }}。
{# 输出：库存有 4 cherries。 #}

如何将 pluralize 过滤器应用到模板中？

在 AnQiCMS 模板中，您通常需要从数据标签中获取数量值，然后将其与 pluralize 过滤器结合使用。

1. 获取评论数量并显示： 假设您在文章详情页需要显示当前文章的评论数量。您可以使用 archiveDetail 标签获取 CommentCount：

{% archiveDetail archiveInfo with name="CommentCount" %}
<p>
    文章共有 {{ archiveInfo }} 条评论{{ archiveInfo|pluralize:"y,ies" }}。
</p>

这里我们假设“评论”的词根是“评论”，单数是“评论y”，复数是“评论ies”。如果您的语言是中文，并且单词本身没有单复数概念，那么直接显示数量即可，或者将其用于其他支持单复数变化的语言文本中。

2. 在循环中显示项目数量： 在 for 循环中，forloop.Counter 或 forloop.Revcounter 可以提供当前循环的索引，这也可以作为数量值。

{% archiveList archives with type="list" limit="10" %}
    {% for item in archives %}
        <p>这是第 {{ forloop.Counter }} 篇文章{{ forloop.Counter|pluralize }}。</p>
        {# 假设 forloop.Counter 是 1，输出：这是第 1 篇文章。 #}
        {# 假设 forloop.Counter 是 2，输出：这是第 2 篇文章s。 #}
    {% endfor %}
{% endarchiveList %}

3. 显示分类下的文档数量： 如果您想在分类列表中显示每个分类下的文档总数，可以使用 categoryList 标签获取 ArchiveCount。

{% categoryList categories with moduleId="1" parentId="0" %}
    {% for category in categories %}
        <p>分类“{{ category.Title }}”有 {{ category.ArchiveCount }} 篇文档{{ category.ArchiveCount|pluralize }}。</p>
        {# 假设 category.ArchiveCount 是 1，输出：分类“AnQiCMS”有 1 篇文档。 #}
        {# 假设 category.ArchiveCount 是 10，输出：分类“Go语言”有 10 篇文档s。 #}
    {% endfor %}
{% endcategoryList %}

小结

pluralize 过滤器是 AnQiCMS 模板中一个虽小但功能强大的特性，它通过简洁的语法帮助我们根据数量动态调整文本的单复数形式，从而提升网站内容的精确性和用户阅读体验。通过灵活运用其默认、单参数和双参数的用法，您可以轻松应对各种单复数显示的需求，让您的网站内容更加地道、专业。

常见问题 (FAQ)

1. pluralize 过滤器是否支持中文单词的单复数形式？ 答：pluralize 过滤器主要针对具有单复数概念的语言（如英语）设计。对于中文这类本身没有单复数变化的语言，直接使用 pluralize 可能没有实际意义，因为中文的“1 条评论”和“5 条评论”中的“评论”本身就没有复数形式。在这种情况下，您可以选择不使用 pluralize，直接显示数量和中文词汇即可。如果您是在英文模板中使用中文词汇，并希望为它们模拟单复数，则需要根据具体的英文语境规则来手动配置 pluralize 的后缀。

2. 如果我有一个特殊复数形式的单词，例如 “child” 的复数是 “children”，pluralize 过滤器能处理吗？ 答：pluralize 过滤器通过添加后缀来生成复数形式，对于像 “child” -> “children” 这种不规则的复数形式，它无法直接通过后缀规则处理。在这种情况下，您需要手动在模板中编写条件判断，或者预先处理好数据，或者使用其他更复杂的逻辑来显示不规则的单复数。例如：

{% set count = 3 %}
{% if count == 1 %}
    {{ count }} child
{% else %}
    {{ count }} children
{% endif %}