在网站运营中，友情链接是提升网站权重、促进SEO的重要一环，也能为用户提供更多有价值的外部资源。然而，在网站建设过程中，友情链接并非总是满满当当。如果友情链接列表为空，却仍然在页面上显示一个空荡荡的链接区域，无疑会影响网站的整体美观和专业度。

安企CMS（AnQiCMS）提供了灵活的模板标签，让我们能够智能地判断友情链接列表是否为空，并根据实际情况决定是否显示相应的区块。接下来，我们将探讨如何在您的AnQiCMS模板中实现这一功能。

AnQiCMS如何获取友情链接列表

首先，我们需要在模板中获取友情链接的数据。在AnQiCMS中，获取友情链接列表非常简单，我们只需使用内置的linkList标签。它会从后台获取所有已配置的友情链接，并将其赋值给一个我们定义的变量，例如friendLinks。

基本的用法如下：

{% linkList friendLinks %}
    {# 此时，friendLinks变量就包含了所有友情链接信息的数组对象 #}
    {# ...这里是处理friendLinks的代码... #}
{% endlinkList %}

一旦friendLinks变量被赋值，我们就可以利用它来判断列表中是否有内容了。

判断列表是否为空：两种实用方法

根据您希望如何处理列表为空时的显示效果，AnQiCMS模板引擎提供了两种实用且灵活的方法来判断并控制友情链接区块的显示。

方法一：利用 {% if ... %} 标签包裹整个区块

这是最直观、简洁的判断方式。您可以通过{% if ... %}条件标签来检查friendLinks变量是否包含任何数据。在AnQiCMS的模板逻辑中，一个非空的数组或列表会被判定为真（true），而一个空列表则会被判定为假（false）。

这种方法适用于您希望当没有任何友情链接时，整个友情链接区块（包括标题、外边框等）都不显示的情况。

{% linkList friendLinks %}
    {% if friendLinks %} {# 判断friendLinks是否非空 #}
        <div class="friendship-links-block">
            <h3>友情链接</h3>
            <ul class="link-list">
                {% for item in friendLinks %}
                    <li>
                        <a href="{{ item.Link }}" {% if item.Nofollow == 1 %}rel="nofollow"{% endif %} target="_blank">
                            {{ item.Title }}
                        </a>
                    </li>
                {% endfor %}
            </ul>
        </div>
    {% endif %}
{% endlinkList %}

在上面的代码中，只有当friendLinks变量中确实存在友情链接时，整个<div class="friendship-links-block">及其内部内容才会被渲染到页面上。这样，您的网站在没有友情链接时，该区域将完全不占用页面空间，保持页面的整洁。

方法二：利用 {% for ... empty ... endfor %} 循环结构在区块内部显示提示

AnQiCMS模板引擎提供了一种更优雅、更适合在列表为空时显示提示信息的循环结构：{% for ... empty ... endfor %}。

这个结构在遍历friendLinks数组时，如果数组中有内容，就会执行for区块内的代码，逐一显示友情链接；如果数组为空，则会执行empty区块内的代码，此时您可以显示一段提示信息，而不是留白。

这种方法适用于您希望友情链接区块的标题和外框总是显示，但在没有具体链接时，在列表位置显示一句如“目前暂无友情链接”的提示语。

{% linkList friendLinks %}
    <div class="friendship-links-block">
        <h3>友情链接</h3>
        <ul class="link-list">
            {% for item in friendLinks %}
                <li>
                    <a href="{{ item.Link }}" {% if item.Nofollow == 1 %}rel="nofollow"{% endif %} target="_blank">
                        {{ item.Title }}
                    </a>
                </li>
            {% empty %} {# 当friendLinks为空时，执行这里的内容 #}
                <li class="no-links-message">目前暂无友情链接，敬请期待。</li>
            {% endfor %}
        </ul>
    </div>
{% endlinkList %}

通过这种方式，即使没有友情链接，用户也能看到一个友好的提示，而不是一个可能引起困惑的空区域。

实际应用中的考量

选择哪种方法取决于您网站的设计需求和用户体验目标。

  • 如果您的目标是绝对的隐藏，即当无链接时不显示任何与友情链接相关的元素，那么方法一（使用 {% if friendLinks %} 包裹整个区块）是您的首选。
  • 如果您希望友情链接区块始终可见，但内容根据是否有链接而变化（有链接显示链接，无链接显示提示），那么方法二（使用 {% for ... empty ... endfor %} 结构）则更为合适。

无论选择哪种方式，都建议将相关的HTML和AnQiCMS模板逻辑整理在一个单独的模板片段文件（例如partial/friendship_links.html）中，然后通过{% include "partial/friendship_links.html" %}在需要显示的位置引入，这样可以提高模板的复用性和可维护性。

总结

通过合理运用AnQiCMS提供的{% if %}条件标签和{% for ... empty ... endfor %}循环结构，我们可以轻松地控制友情链接区块的显示逻辑。这不仅能让您的网站在数据变化时保持界面的动态适应性，更能提升用户的浏览体验，展现网站的专业与细致。希望这些技巧能帮助您更好地运营AnQiCMS搭建的网站。

常见问题 (FAQ)

1. linkList 标签中的 friendLinks 变量名是固定的吗？

不是固定的。{% linkList friendLinks %} 中的 friendLinks 只是