首页幻灯片
首页幻灯片
首页幻灯片用于维护首页 Banner 图片及其链接、ALT 和简介,按分组管理,供模板调用展示。
入口路径
后台顶部菜单 →「设置」→「首页幻灯片」。实际地址:/system/setting/banner,需要管理员权限(canAdmin)。
功能说明
页面按分组展示 Banner 列表(源码默认分组为 default),支持添加、修改、删除和预览。每条 Banner 包含图片、链接、ALT 文本和简介。
界面截图

设置项说明
| 设置项 | 作用 | 取值 / 默认 | 怎么选 / 填写建议 | 影响 / 注意 |
|---|---|---|---|---|
| 幻灯片分组 | 决定这组 Banner 归属哪个位置 | select,可在下拉内新增;默认 default [源码+实测] |
多位置轮播时按位置命名,如 home、activity |
模板用 type 指定分组,大小写敏感;未提交时前端兜底 default [源码] |
| 幻灯片图片 | Banner 图片 | 图片上传,无默认 [源码] | 按模板要求尺寸上传;同组保持相同宽高比 | 图片过大影响加载,建议开启 Webp 与压缩 |
| 链接地址 | 点击 Banner 的跳转地址 | URL,留空则不可点击 [源码] | 填完整 URL 或站内**路径 | 外链是否新开窗口由模板决定 |
| ALT | 图片替代文字 | 文本,无默认 [源码] | 简明描述图片内容 | 有利于 SEO 和无障碍访问;源码另有兼容字段 title 但前端未暴露 |
| 介绍 | Banner 的文字说明 | 文本,无默认 [源码] | 写简短活动说明 | 是否输出由模板决定 |
配置项详解
幻灯片分组
出现条件:页面顶部分组标签 + 新增弹窗中的「幻灯片分组」下拉 [实测]。
源码默认 default(config/setting.go:111,116,120);新增分组名必填,可在下拉框中直接新增 [源码]。
推荐值:单位置站点保持 default;多轮播位按位置命名,模板用 {% bannerList banners with type="分组名" %} 调用。
填错后果:模板 type 与分组名不一致(含大小写)会读不到数据。
操作步骤
- 进入「设置 → 首页幻灯片」。
- 选择分组,点击「添加」。
- 上传图片并填写链接、ALT、简介。
- 点击预览确认效果,再保存。
- 需要修改时点「修改」,不再使用点「删除」(有确认弹窗)。
适用场景与建议
- 多位置轮播:为首页、活动页分别建分组,模板按分组调用,互不干扰。
- 图片尺寸:同一分组的 Banner 使用相同宽高比,避免轮播时页面跳动。
前台调用示例
{% bannerList banners with type="default" %}
{% for item in banners %}
<a href="{{ item.Link }}" target="_blank">
<img src="{{ item.Image }}" alt="{{ item.Alt }}" />
</a>
{% endfor %}
{% endbannerList %}
不传 type 时输出默认分组。循环内可用 forloop.Counter 判断是否为**张。
注意事项
- 分组名要与模板调用时的
type完全一致,大小写敏感。 - 删除 Banner 有确认弹窗,删除后前台会立即少一条数据。
- 图片 URL 变更后如果前台仍显示旧图,清理缓存。