原生JavaScript实现简易轮播图：核心逻辑与完整代码解析
作者：小括号时间：2026-10-24 15:21:42浏览：247
本文详细解析如何使用原生JavaScript实现一个具备自动播放、左右箭头切换及底部指示器点击功能的简易轮播图。文章从DOM元素获取、动画函数封装、边界处理逻辑到定时器控制进行逐步拆解，并提供完整的HTML、CSS及JS代码示例，帮助开发者掌握前端轮播组件的核心实现原理。
本文分享了一段使用原生JavaScript实现的简易轮播图代码示例，供开发者参考学习。
最终实现的视觉效果如下所示：
接下来对实现思路进行整体分析。
具体效果表现如下：
从功能实现角度进行拆解分析。
首先，通过 document.querySelector('.类名') 方法获取轮播图相关DOM元素：包括主容器（.carousel）、左右按钮父容器（.chevron）、左右切换按钮（.chevron-left 和 .chevron-right）、图片列表父容器ul（.carousel-body）以及底部指示器li（.indicators li）。注意此处获取的是ul而非li，因为轮播图移动时是整个ul容器发生位移。
//装轮播图的大盒子
let oCarousel = document.querySelector('.carousel')
//装轮播图左右按钮的标签的父元素
let oChevron = document.querySelector('.chevron')
//左按钮
let oLeft = document.querySelector('.chevron-left')
//右按钮
let oRight = document.querySelector('.chevron-right')
//获取放轮播图图片的父元素ul
let oUl = document.querySelector('.carousel-body')
//获取装轮播图图片的li
let oActives = document.querySelectorAll('.indicators li')其次，实现通过点击左右按钮触发轮播图切换至上一张或下一张的功能。
为此，先封装一个通用的 animation() 函数，以便在多次切换场景中复用。
function animation(obj,target){
// 清除定时器
clearInterval(obj.timer)
obj.timer=setInterval(()=>{
// 读取元素当前位置
let curX=obj.offsetLeft
//定义一个步长
let step=10
// 判断将要移动的方向(比较目标位置与当前位置的大小)
if(target<curX){
step=-10
}
// 根据当前位置与目标位置，以及步长的关系判断
// 只要目标位置与当前位置之间的距离 < 步长，就直接将元素的位置设置为目标为位置即可
if(Math.abs(target-curX)<Math.abs(step)){
obj.style.left=target+'px'
clearInterval(obj.timer)
}else{
// 计算下一步的位置
let nextX=curX+step
// 将下一步的位置赋值给obj.style.left
obj.style.left=nextX+'px'
}
},10)
}首先处理鼠标交互逻辑：默认状态下左右箭头隐藏，当鼠标移入轮播图区域时显示箭头，移出时隐藏。因此，需为主容器（.carousel）绑定 onmouseover 和 onmouseout 事件。
oCarousel.onmouseover = function () {
oChevron.style.display = "block"
}
oCarousel.onmouseout = function () {
oChevron.style.display = "none"
}接着为左右按钮绑定点击事件。定义全局变量 n 记录当前图片索引，定义全局变量 step 为500（即每张图的宽度，作为每次移动的步长）。
let n = 0
let step = 500
oLeft.onclick = function () {
n--
if (n == -1) {
//当移到第一张(n=0)，再次点击时(n=-1)，将n设置为4，跳转到最后一张图片的位置
//装轮播图图片的ul的位置改为最后一张图片的位置（因为一张图片width为500px，所以最后一张在5*500=2500的位置）
oUl.style.left = -2500 + 'px'
n = 4
}
//target为移动距离，即：第n张图片 * 每张图片的width
let target = -n * step
animation(oUl, target)
}
oRight.onclick = function () {
n++
if (n == 6) {
//当移到第最后一张(n=5)，再次点击时(n=6)，将n设置为1，跳转到第一张图片的位置
oUl.style.left = 0 + 'px'
n = 1
}
let target = -n * step
animation(oUl, target)
}第三部分实现点击底部数字指示器切换图片的功能。
//因为上面通过document.querySelectorAll('.indicators li') 获取到的li是通过伪数组的形式返回的，使用需要遍历该伪数组为每个li绑定点击事件
for (let i = 0; i < oActives.length; i++) {
oActives[i].onclick = function () {
//为被点击的第i个设置样式为高亮
setActive(i)
//并且把i的值赋值给n（相当于记录当前应该显示第i张图片）
n = i
//设置移动的距离
let target = -n * step
animation(oUl, target)
}
}
// 封装一个函数，实现li的高亮
function setActive(ind) {
//使用排他思想：清除全部，然后在单独设置类名
for (let j = 0; j < oActives.length; j++) {
oActives[j].className = ''
}
oActives[ind].className = 'active'
}同时修复第二步中点击箭头切换时，底部高亮指示器未同步更新的问题。
oLeft.onclick = function () {
n--
if (n == -1) {
oUl.style.left = -2500 + 'px'
n = 4
}
//调用setActive()函数，修改第n张图片页码的高亮状态
setActive(n)
let target = -n * step
animation(oUl, target)
}
oRight.onclick = function () {
n++
if (n == 6) {
oUl.style.left = 0 + 'px'
n = 1
}
//如果n为5时，表示已经到了第6张图片（而第六张图片是和第1张一样的，只是用来滑动过渡，防止瞬间跳转的效果）所以需要设置页码为0（即第一张图片）的高亮状态
//这里使用了三元表达式，如果n为5，则设置第1张图片为高亮，否则设置第n张为高亮
n == 5 ? setActive(0) : setActive(n)
let target = -n * step
animation(oUl, target)
}最后设置自动播放定时器：当鼠标移入轮播图区域时清除定时器以暂停自动播放，鼠标移出时重新开启定时器恢复自动播放。
//在加载页面时应该先开启定时器，否则轮播图不能自动播放，需要等待一次移入且移出事件才会开启定时器
timer = setInterval(function () {
//调用右侧按钮绑定的点击事件
oRight.onclick()
}, 2000)
//鼠标移入时，显示左右箭头，并且清除定时器
oCarousel.onmouseover = function () {
oChevron.style.display = "block"
clearInterval(timer)
}
//鼠标移出时，隐藏左右箭头，并且开启定时器
oCarousel.onmouseout = function () {
oChevron.style.display = "none"
timer = setInterval(function () {
oRight.onclick()
}, 2000)
}以下是完整的实现代码。
对应的CSS样式代码如下：
* {
margin: 0;
padding: 0;
}
.carousel {
width: 500px;
height: 200px;
border: 1px solid red;
margin: 100px auto;
position: relative;
overflow: hidden;
}
.carousel li {
list-style: none;
}
/* 轮播内容 */
.carousel-body {
width: 3000px;
height: 200px;
position: absolute;
}
.carousel-body li {
list-style: none;
float: left;
width: 500px;
height: 200px;
}
.carousel-body li img {
width: 100%;
height: 100%;
}
/* 左右焦点按钮 */
.carousel .chevron {
position: absolute;
top: 50%;
height: 40px;
width: 100%;
transform: translateY(-50%);
display: none;
}
.carousel .chevron-left,
.carousel .chevron-right {
width: 40px;
height: 40px;
background: #000;
cursor: pointer;
text-align: center;
line-height: 40px;
font-size: 30px;
font-weight: bold;
color: #fff;
opacity: .3;
border: 1px solid #fff;
}
.carousel .chevron-left {
float: left;
margin-left: 10px;
}
.carousel .chevron-right {
float: right;
margin-right: 10px;
}
/* 5.2 轮播指示器结构 */
.carousel .indicators {
position: absolute;
right: 30px;
bottom: 20px;
}
.carousel .indicators li {
float: left;
width: 20px;
height: 20px;
margin-right: 10px;
background: rgba(255, 255, 255, .8);
text-align: center;
line-height: 20px;
cursor: pointer;
color: rgba(0, 0, 0, .5);
}
.carousel .indicators li.active {
background: #09f;
color: red;
}HTML结构代码如下：
<div class="carousel">
<!-- 轮播内容 -->
<ul class="carousel-body">
<li><a href="#"><img src="./images/1.jpg" alt=""></a></li>
<li><a href="#"><img src="./images/2.jpg" alt=""></a></li>
<li><a href="#"><img src="./images/3.jpg" alt=""></a></li>
<li><a href="#"><img src="./images/4.jpg" alt=""></a></li>
<li><a href="#"><img src="./images/5.jpg" alt=""></a></li>
<li><a href="#"><img src="./images/1.jpg" alt=""></a></li>
<!-- a3.1 新增1个li与第1张相同 -->
<!-- <li><a href="#"><img src="./images/1.jpg" alt=""></a></li> -->
</ul>
<!-- 左右焦点按钮 -->
<div class="chevron">
<div class="chevron-left">«</div>
<div class="chevron-right">»</div>
</div>
<!-- 5.1 轮播指示器结构 -->
<ol class="indicators">
<li class="active">1</li>
<li>2</li>
<li>3</li>
<li>4</li>
<li>5</li>
</ol>
</div>JavaScript逻辑代码如下：
let oCarousel = document.querySelector('.carousel')
let oChevron = document.querySelector('.chevron')
let oLeft = document.querySelector('.chevron-left')
let oRight = document.querySelector('.chevron-right')
let oUl = document.querySelector('.carousel-body')
let oActives = document.querySelectorAll('.indicators li')
let n = 0
let step = 500
let timer
timer = setInterval(function () {
oRight.onclick()
}, 2000)
oCarousel.onmouseover = function () {
oChevron.style.display = "block"
clearInterval(timer)
}
oCarousel.onmouseout = function () {
oChevron.style.display = "none"
timer = setInterval(function () {
oRight.onclick()
}, 2000)
}
oLeft.onclick = function () {
n--
if (n == -1) {
oUl.style.left = -2500 + 'px'
n = 4
}
setActive(n)
let target = -n * step
animation(oUl, target)
}
oRight.onclick = function () {
n++
if (n == 6) {
oUl.style.left = 0 + 'px'
n = 1
}
n == 5 ? setActive(0) : setActive(n)
let target = -n * step
animation(oUl, target)
}
for (let i = 0; i < oActives.length; i++) {
oActives[i].onclick = function () {
setActive(i)
n = i
let target = -n * step
animation(oUl, target)
}
}
// 封装一个函数，实现li的高亮
function setActive(ind) {
for (let j = 0; j < oActives.length; j++) {
oActives[j].className = ''
}
oActives[ind].className = 'active'
}
function animation(obj,target){
// 清除定时器
clearInterval(obj.timer)
obj.timer=setInterval(()=>{
// 读取元素当前位置
let curX=obj.offsetLeft
//定义一个步长
let step=10
// 判断将要移动的方向(比较目标位置与当前位置的大小)
if(target<curX){
step=-10
}
// 根据当前位置与目标位置，以及步长的关系判断
// 只要目标位置与当前位置之间的距离 < 步长，就直接将元素的位置设置为目标为位置即可
if(Math.abs(target-curX)<Math.abs(step)){
obj.style.left=target+'px'
clearInterval(obj.timer)
}else{
// 计算下一步的位置
let nextX=curX+step
// 将下一步的位置赋值给obj.style.left
obj.style.left=nextX+'px'
}
},10)
}以上即为原生JS实现简易轮播图的完整教程，希望能为读者提供学习帮助，欢迎继续支持本站获取更多前端技术内容。
作者最新文章
JS语法错误会阻止加载吗？区分SyntaxError与资源加载失败
2026-11-05 16:08:46
JavaScript常见SyntaxError语法错误排查与修复方法
2026-11-05 13:58:44
JS中slice、substring和substr截取字符串的区别
2026-11-05 13:43:47
JS 转 TS 手动迁移最佳实践：从配置 tsconfig 到消除 any 类型
2026-11-05 11:53:32
为什么JS数组push后得到的是数字而不是数组？
2026-11-05 09:59:18