在安企CMS的模板设计中，我们经常会遇到需要动态展示内容的需求，例如随机推荐文章、随机显示产品图片，或者从一组预设的关键词中随机选择一个进行展示。为了实现这种灵活多变的内容呈现，安企CMS提供了简洁而强大的模板过滤器，其中就包括能够从字符串或数组中随机获取一个字符或值的 random 过滤器。
理解并熟练运用 random 过滤器，能够让我们的网站内容更具活力和新鲜感，有效提升用户体验。接下来，我们将详细探讨如何在AnQiCMS模板中，运用这个实用的功能。
核心功能：random 过滤器解析
random 过滤器是AnQiCMS模板引擎内置的一个非常方便的功能。它的主要作用是从给定的字符串或数组（在模板中通常称为列表或切片）中，随机抽取并返回一个元素。
基本用法非常直观：
{{ obj|random }}
其中 obj 可以是一个字符串变量，也可以是一个包含多个值的数组变量。当应用于字符串时，它会随机返回字符串中的一个字符；当应用于数组时，它会随机返回数组中的一个元素。
场景一：从字符串中随机获取一个字符或子串
假设我们有一个包含多种信息的字符串，我们希望从中随机抽取一部分内容进行展示。
方法一：将字符串拆分为字符数组
如果你想从一个较长的字符串中随机抽取一个独立的汉字、英文字母或符号，可以先使用 make_list 过滤器将字符串转换为单个字符组成的数组，然后再应用 random 过滤器。
示例代码：
{# 假设我们有一个字符串变量叫做 articleTitle #}
{% set articleTitle = "安企CMS，让内容管理更简单高效！" %}
{# 从字符串中随机获取一个字符 #}
<p>今天为您推荐的幸运字符是：<b>{{ articleTitle|make_list|random }}</b></p>
这段代码会先将 articleTitle 转换为 ["安", "企", "C", "M", "S", "，", "让", "内", "容", "管", "理", "更", "简", "单", "高", "效", "！"] 这样的数组，然后 random 过滤器会从这个数组中随机选取一个字符并显示。
方法二：将字符串按分隔符拆分为子串数组
如果你的字符串是由特定分隔符（例如逗号、空格、竖线等）连接起来的多个词语或短语，并且你希望随机抽取其中一个词语，那么 split 过滤器就派上用场了。
示例代码：
{# 假设有一个关键词字符串 #}
{% set keywords = "高效,定制,易扩展,中小企业,内容运营,多站点" %}
{# 将关键词字符串按逗号和空格拆分为数组，然后随机选择一个 #}
<p>今日关键词推荐：<b>{{ keywords|split:", "|random }}</b></p>
这里 split:", " 会将字符串 keywords 按照 “, “（逗号加空格）这个分隔符拆分成一个数组 ["高效", "定制", "易扩展", "中小企业", "内容运营", "多站点"]，random 过滤器再从中随机选取一个词语进行显示。
场景二：从数组（列表）中随机获取一个值
AnQiCMS的模板标签，如获取文章列表（archiveList）、分类列表（categoryList）、友情链接（linkList）等，都会返回一个数组（或者说是列表对象）。直接对这些列表应用 random 过滤器，可以方便地从中随机抽取一个完整的元素。
获取随机对象及其属性
当 random 过滤器应用于一个包含对象的数组时，它会返回一个随机的对象。然后你可以通过点 . 语法来访问这个对象的具体属性。
示例代码：随机推荐一篇热门文章
{# 使用 archiveList 标签获取最近10篇热门文章，并存入 archives 变量 #}
{% archiveList archives with type="list" order="views desc" limit="10" %} {% endarchiveList %}
{% if archives|length > 0 %}
{# 从热门文章列表中随机选取一篇 #}
{% set randomArticle = archives|random %}
<div class="random-recommendation">
<h4>随机推荐：</h4>
<a href="{{ randomArticle.Link }}" title="{{ randomArticle.Title }}">
{# 访问随机文章的标题和链接等属性 #}
<img src="{{ randomArticle.Thumb }}" alt="{{ randomArticle.Title }}" class="img-fluid">
<h5>{{ randomArticle.Title }}</h5>
<p>{{ randomArticle.Description|truncatechars:50 }}</p>
</a>
</div>
{% else %}
<p>暂无文章可供随机推荐。</p>
{% endif %}
在这段代码中，我们首先通过 archiveList 获取了一个文章列表，并检查它是否为空。如果列表不为空，archives|random 就会从这个列表中随机抽取一篇文章对象，并将其赋值给 randomArticle。之后，我们就可以像访问普通文章对象一样，获取 randomArticle 的 Link、Title、Thumb、Description 等属性。
示例代码：随机展示一个友情链接
{# 获取所有友情链接，并存入 friendLinks 变量 #}
{% linkList friendLinks %} {% endlinkList %}
{% if friendLinks|length > 0 %}
{# 从友情链接列表中随机选取一个 #}
{% set randomLink = friendLinks|random %}
<div class="random-friend-link">
<p>友情推荐：<a href="{{ randomLink.Link }}" {% if randomLink.Nofollow == 1 %}rel="nofollow"{% endif %} target="_blank">{{ randomLink.Title }}</a></p>
</div>
{% else %}
<p>暂无友情链接。</p>
{% endif %}
这里逻辑与文章推荐类似，随机选取一个 link 对象，并显示其 Title 和 Link。
从静态数组中随机获取值
虽然AnQiCMS的强大之处在于动态内容管理，但在某些特定场景下，你可能需要在模板中定义一个静态数组，并从中随机选取。这时可以使用 list 过滤器。
示例代码：随机显示一个预设的问候语
{# 定义一个包含问候语的静态数组 #}
{% set greetings = '["您好！", "欢迎光临！", "很高兴见到您！", "祝您今天愉快！"]'|list %}
{# 从问候语数组中随机选择一个 #}
<p><b>{{ greetings|random }}</b></p>
实用技巧与注意事项
- 结果的不可预测性：
random过滤器每次页面加载时都会重新计算，这意味着每次刷新页面，你可能会看到不同的随机结果。这正是其动态性和魅力的来源。 - 空值检查：在使用
random过滤器之前，最好先通过|length过滤器检查字符串或数组是否为空。如果obj为空字符串或空数组，|random可能会返回空值，导致页面显示不符合预期。上面的例子中都包含了if obj|length > 0这样的判断。 - 链式操作：
random过滤器可以与其他过滤器进行链式操作，如|split | random。这种组合使用能够实现更复杂的随机抽取逻辑。 - 性能考量：虽然
random过滤器本身效率很高，但如果你的列表非常庞大（例如上万个元素），且需要频繁进行随机抽取，可能需要考虑在数据层面或