网站的Banner区域，如同一个动态的宣传窗口，它的视觉吸引力和内容传达效率，直接影响着访客对网站的第一印象。一个精心设计的Banner，能够迅速抓住用户目光，有效地展示品牌形象、最新活动或核心产品。在AnQiCMS（安企CMS）中，利用其强大的内容管理功能，您可以轻松实现动态Banner图片列表的配置与展示，让您的网站始终保持新鲜感和吸引力。
理解AnQiCMS中的Banner配置逻辑
在AnQiCMS里，配置动态Banner图片列表是一个直观且灵活的过程。通常，这些可轮播的图片可以直接关联到网站的特定内容单元，比如某个分类页面或独立的单页面。
当您在后台编辑一个文档分类或单页面时，会发现一个专门用于设置“Banner图”的区域。在这里，您可以上传多张图片，系统会将它们视为该特定分类或页面的Banner组图。为了确保前端显示效果的协调统一，我们通常会建议您上传尺寸一致的图片。
除了这种页面级别的Banner设置，AnQiCMS还提供了更高级的Banner管理方式。通过后台的相应功能模块，您可以创建和管理多个独立的Banner分组。这意味着，您可以为网站的首页、不同的专题活动页，甚至是季节性推广活动，分别设计和配置一套专属的Banner图片。每个分组都可以拥有其独特的图片集，并通过一个自定义的名称进行标识。这种细致入微的配置能力，为网站内容运营带来了极大的灵活性和便利。
巧用bannerList标签：动态Banner展示的核心
要将后台精心配置的动态Banner图片列表呈现在网站前端，AnQiCMS提供了一个核心的模板标签——bannerList。这个标签是实现动态Banner显示的关键所在，它能够根据您的配置，获取并提供相应的Banner图片数据，供您在模板中进行灵活的遍历和渲染。
bannerList标签的基本使用形式是：{% bannerList 变量名称 %}。您可以为它指定一个便于在模板中识别的变量名，例如banners。随后，通过标准的循环结构，如{% for item in banners %}，您就可以逐一访问并处理列表中的每一张Banner图片。
该标签还支持一些实用的参数，以便您对获取的Banner数据进行更精细的控制：
siteId： 如果您的AnQiCMS部署了多站点管理功能，并且您希望调用其他站点的Banner数据，可以使用此参数指定目标站点的ID。但在大多数单站点应用场景中，此参数通常无需设置。type： 这是bannerList标签最常用的参数之一。默认情况下，如果不指定type参数，它将获取“default”分组下的Banner图片。但如果您在后台创建了多个Banner分组（例如“首页幻灯”、“产品展示Banner”等），就可以通过设置type="分组名称"来精确调用特定分组的Banner图片列表。这使得您能够在网站的不同区域，按需展示不同的Banner集合，极大地丰富了页面的表现力。
在循环内部，item变量代表列表中的每一张Banner图片，它包含了以下几个可供您在模板中调用的关键字段：
Id： 每张Banner图片在系统中的唯一标识ID。Logo： Banner图片在服务器上的完整URL地址，这是显示图片的核心字段。Link： 当访客点击Banner图片时，将跳转到的目标URL地址。Description： Banner图片的描述信息，通常可以作为图片标题或简要说明。Alt： 图片的替代文本（Alt Text），这对于SEO优化和提升网站可访问性（例如，当图片无法加载或供视障用户阅读时）都非常重要。
实践指南：在模板中显示动态Banner图片列表
理解了bannerList标签的强大功能后，接下来我们将演示如何将其应用于您的网站模板。假设您希望在网站首页展示一个轮播Banner，并且这些图片已在后台配置到一个名为“首页幻灯”的分组中。
您可以在网站的index.html或其他需要显示Banner的模板文件中，编写类似如下的代码片段：
<div class="main-banner-container"> {# 假设这是一个用于Banner轮播的外部容器 #}
{% bannerList homeBanners with type="首页幻灯" %} {# 获取“首页幻灯”分组的Banner列表 #}
{% for bannerItem in homeBanners %}
<a href="{{bannerItem.Link}}" target="_blank" class="banner-slide {% if forloop.Counter == 1 %}active-slide{% endif %}">
{# 结合thumb过滤器生成缩略图，并用于懒加载，提高性能 #}
<img src="{{bannerItem.Logo|thumb}}" alt="{{bannerItem.Alt}}" loading="lazy" class="responsive-banner-image"/>
{% if bannerItem.Description %}
<div class="banner-text-overlay">
<h3>{{bannerItem.Description}}</h3>
</div>
{% endif %}
</a>
{% endfor %}
{% endbannerList %}
</div>
让我们