- 后台准备:上传图片、填写信息,并生成相应的数据。
- 前台调用:修改模板文件,使用代码调用后台的数据并配合JS/CSS实现轮播效果。
下面我将为你提供一个详细、完整的图文步骤教程,使用最主流、最简单的 jQuery Slick 轮播插件作为示例。

第一步:后台准备工作
在后台,我们需要创建一个专门的栏目来存放轮播图内容,这样管理起来非常清晰。
创建专属栏目
- 登录织梦后台。
- 在左侧菜单栏找到「内容管理」 -> 「栏目管理」。
- 点击「增加顶级栏目」。
- 填写栏目信息:
- 栏目名称:给个清晰的名字,“首页轮播图”。
- 栏目目录:系统会自动生成,保持默认即可。
- 栏目类型:选择 “频道”。
- 列表模板:暂时不用管,我们不会用到这个栏目的列表页。
- 发布选项:确保 “允许发布文章” 是勾选状态。
- 点击 “确定” 保存。
上传并添加轮播图内容
-
在左侧菜单栏找到 「内容管理」 -> 「添加文档」。
-
在 “选择栏目” 中,选择你刚刚创建的 “首页轮播图”。
-
- 这张图片的标题(可选,轮播效果中通常不显示)。
- 缩略图:这是最关键的一步! 点击 “上传新文件”,选择你想要轮播的图片,然后上传,上传成功后,图片会自动填入这里。
- :这里可以填写图片的描述文字,如果想在轮播时显示文字,就在这里写。
- 自定义属性:可以勾选 “推荐”,但这不是必须的。
-
点击 “确定” 发布。
(图片来源网络,侵删) -
重复第3步,将你想要展示的所有轮播图都添加到这个 “首页轮播图” 栏目中。
第二步:前台模板制作
我们需要修改首页模板文件 (index.htm),把后台的数据调用出来并展示成轮播图。
下载并准备轮播插件
我们使用功能强大且易于使用的 Slick 轮播插件。
-
访问 Slick 官网下载:https://kenwheeler.github.io/slick/
(图片来源网络,侵删) -
下载后,你会得到一个文件夹,里面包含
slick.css、slick-theme.css、slick.min.js等文件。 -
将这些文件上传到你的模板目录下,
/templets/default/目录里,新建一个名为js和css的文件夹来存放它们,结构如下:/templets/default/ ├── css/ │ └── slick.min.css │ └── slick-theme.min.css ├── js/ │ └── slick.min.js ├── images/ ├── index.htm <-- 我们要修改的文件 └── ...
修改首页模板 (index.htm)
打开你的首页模板文件 (/templets/default/index.htm),按照以下步骤操作:
A. 引入 CSS 和 JS 文件
在 <head> 标签内,引入 Slick 的 CSS 文件:
<head>
<meta charset="UTF-8">{dede:global.cfg_webname/}</title>
<!-- 引入 Slick 的 CSS 文件 -->
<link rel="stylesheet" type="text/css" href="{dede:global.cfg_templets_dir/}/css/slick.min.css" />
<link rel="stylesheet" type="text/css" href="{dede:global.cfg_templets_dir/}/css/slick-theme.min.css" />
<!-- ... 其他原有的CSS ... -->
</head>
在页面底部 </body> 标签之前,引入 jQuery 库和 Slick 的 JS 文件。注意:Slick 依赖 jQuery,所以必须先引入 jQuery。
<!-- ... 其他原有的JS ... -->
<!-- 首先引入 jQuery (如果你的模板没有引入的话) -->
<script src="https://cdn.bootcdn.net/ajax/libs/jquery/3.6.0/jquery.min.js"></script>
<!-- 然后引入 Slick 的 JS 文件 -->
<script type="text/javascript" src="{dede:global.cfg_templets_dir/}/js/slick.min.js"></script>
<script type="text/javascript">
$(document).ready(function(){
// 调用 Slick 初始化轮播图
$('.slider-for').slick({
slidesToShow: 1, // 显示一个
slidesToScroll: 1, // 滚动一个
arrows: true, // 显示左右箭头
fade: true, // 淡入淡出效果
asNavFor: '.slider-nav' // 与缩略图联动
});
$('.slider-nav').slick({
slidesToShow: 4, // 显示4个缩略图
slidesToScroll: 1,
asNavFor: '.slider-for',
dots: false, // 不显示圆点
centerMode: false,
focusOnSelect: true // 点击缩略图切换主图
});
});
</script>
</body>
</html>
提示:
{dede:global.cfg_templets_dir/}是织梦获取当前模板目录路径的万能标签,推荐使用。
B. 编写轮播图的 HTML 结构
在你想要显示轮播图的位置(<header> 标签内),添加如下 HTML 代码。
这里我们做一个“大图+缩略图导航”的经典轮播效果:
<!-- 轮播图开始 -->
<div class="slider-container">
<!-- 主轮播图区域 -->
<div class="slider-for">
{dede:arclist typeid='你的栏目ID' row='5'}
<div>
<!-- [field:picname/] 是文章的缩略图地址 -->
<img src="[field:picname/]" alt="[field:title/]">
<!-- 如果需要在图片上显示文字,可以这样 -->
<!-- <div class="text-on-image">[field:title/]</div> -->
</div>
{/dede:arclist}
</div>
<!-- 缩略图导航区域 -->
<div class="slider-nav">
{dede:arclist typeid='你的栏目ID' row='5'}
<div>
<img src="[field:picname/]" alt="[field:title/]">
</div>
{/dede:arclist}
</div>
</div>
<!-- 轮播图结束 -->
代码解释:
{dede:arclist ...}: 这是织梦最常用的文章列表标签。typeid='你的栏目ID': 这是核心! 把'你的栏目ID'替换成你第一步创建的 “首页轮播图” 栏目的 ID,你可以在「栏目管理」中鼠标悬停在栏目名称上,浏览器左下角会显示id=数字,这个参数确保只调用该栏目下的图片。row='5': 表示调用 5 条数据,也就是 5 张图片,根据你的需要修改。[field:picname/]: 这是文章的缩略图标签,会输出你在后台上传的图片地址。
第三步:完善与美化
添加自定义样式(可选)
为了让轮播图更好看,你可以在 <head> 里的 CSS 文件中添加一些自定义样式。
在 slick-theme.min.css 后面添加:
<style type="text/css">
/* 设置轮播图容器的宽高 */
.slider-container {
width: 100%;
max-width: 1200px; /* 最大宽度,根据你的网站布局调整 */
margin: 20px auto; /* 上下间距,左右居中 */
}
/* 主轮播图样式 */
.slider-for img {
width: 100%;
height: auto;
display: block;
}
/* 缩略图导航样式 */
.slider-nav img {
width: 100px;
height: 60px;
margin: 5px;
cursor: pointer;
}
/* Slick 插件可能会生成一些类,可以覆盖它们 */
.slick-prev, .slick-next {
/* 修改箭头样式 */
}
</style>
清理缓存
完成所有修改后,回到织梦后台首页,点击右上角的 “生成” -> “一键更新网站” -> “更新首页”。
然后刷新你的网站首页,就能看到漂亮的图片轮播效果了!
总结与排错
- 轮播图不显示?
- 检查
typeid是否正确。 - 检查
[field:picname/]标签是否在{dede:arclist}内部。 - 检查 JS 和 CSS 文件路径是否正确。
- 检查浏览器控制台 (F12) 是否有报错信息。
- 检查
- 轮播效果不生效?
- 确保 jQuery 库已正确加载。
- 确保
slick.min.js在 jQuery 之后加载。 - 检查 JS 初始化代码是否在
$(document).ready(function(){ ... });内部。 - 检查 HTML 结构中的类名(如
slider-for,slider-nav)是否与 JS 中的一致。
- 想用其他轮播插件?
- 原理完全相同,下载其他插件(如 Swiper, Bootstrap Carousel),将其 CSS 和 JS 文件引入模板,然后按照该插件的官方文档编写 HTML 结构和初始化 JS 代码即可,织梦的
{dede:arclist}调用数据部分是不变的。
- 原理完全相同,下载其他插件(如 Swiper, Bootstrap Carousel),将其 CSS 和 JS 文件引入模板,然后按照该插件的官方文档编写 HTML 结构和初始化 JS 代码即可,织梦的
通过以上步骤,你就可以成功地在织梦首页制作出功能完善的图片轮播了。
