固定寬度容器顯示 N 張圖片,左右箭頭點擊滾動一屏或單張,支持自動輪播、鼠標懸停暫停、循環無縫、響應式適配。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>jQuery 圖片列表左右滾動</title>
<style>
* { box-sizing: border-box; margin: 0; padding: 0; }
body { font-family: 'Microsoft YaHei', sans-serif; background: #f5f5f5; padding: 50px; }
.slider {
width: 800px;
margin: 0 auto;
border: 1px solid #ddd;
border-radius: 8px;
overflow: hidden;
background: #fff;
box-shadow: 0 2px 10px rgba(0,0,0,0.1);
position: relative;
user-select: none;
}
.slider-viewport {
overflow: hidden;
position: relative;
}
.slider-track {
display: flex;
transition: transform 0.4s ease-out;
will-change: transform;
}
.slider-item {
flex: 0 0 200px; /* 固定項寬 */
padding: 10px;
text-align: center;
}
.slider-item img {
width: 100%;
height: 130px;
object-fit: cover;
border-radius: 4px;
border: 1px solid #eee;
}
.slider-btn {
position: absolute;
top: 50%;
transform: translateY(-50%);
width: 40px;
height: 40px;
border: none;
background: rgba(0,0,0,0.5);
color: #fff;
font-size: 20px;
line-height: 40px;
text-align: center;
cursor: pointer;
border-radius: 50%;
transition: background 0.3s;
z-index: 10;
}
.slider-btn:hover { background: rgba(0,0,0,0.8); }
.slider-btn.prev { left: 15px; }
.slider-btn.next { right: 15px; }
.slider-btn.disabled { opacity: 0.3; cursor: not-allowed; pointer-events: none; }
/* 響應式 */
@media (max-width: 820px) {
.slider { width: 100%; border-radius: 0; }
.slider-item { flex: 0 0 160px; }
}
</style>
</head>
<body>
<div class="slider" id="slider">
<button class="slider-btn prev disabled" id="prevBtn" aria-label="上一頁">‹</button>
<div class="slider-viewport">
<div class="slider-track" id="track">
<div class="slider-item"><img src="https://picsum.photos/seed/1/200/130" alt="1"></div>
<div class="slider-item"><img src="https://picsum.photos/seed/2/200/130" alt="2"></div>
<div class="slider-item"><img src="https://picsum.photos/seed/3/200/130" alt="3"></div>
<div class="slider-item"><img src="https://picsum.photos/seed/4/200/130" alt="4"></div>
<div class="slider-item"><img src="https://picsum.photos/seed/5/200/130" alt="5"></div>
<div class="slider-item"><img src="https://picsum.photos/seed/6/200/130" alt="6"></div>
<div class="slider-item"><img src="https://picsum.photos/seed/7/200/130" alt="7"></div>
<div class="slider-item"><img src="https://picsum.photos/seed/8/200/130" alt="8"></div>
</div>
</div>
<button class="slider-btn next" id="nextBtn" aria-label="下一頁">›</button>
</div>
<script src="https://cdn.jsdelivr.net/npm/jquery@3.6.0/dist/jquery.min.js"></script>
<script>
(function($) {
var $slider = $('#slider');
var $track = $('#track');
var $items = $track.children('.slider-item');
var $prev = $('#prevBtn');
var $next = $('#nextBtn');
var itemWidth = $items.outerWidth(true); // 含 margin
var visibleCount = Math.floor($slider.find('.slider-viewport').width() / itemWidth);
var totalItems = $items.length;
var maxIndex = totalItems - visibleCount;
var currentIndex = 0;
var autoTimer = null;
var isAnimating = false;
function updateButtons() {
$prev.toggleClass('disabled', currentIndex === 0);
$next.toggleClass('disabled', currentIndex >= maxIndex);
}
function scrollTo(index, animate) {
if (isAnimating) return;
index = Math.max(0, Math.min(maxIndex, index));
currentIndex = index;
var translateX = -index * itemWidth;
if (animate !== false) {
isAnimating = true;
$track.animate({ left: translateX }, 400, 'easeOutQuad', function() {
isAnimating = false;
});
} else {
$track.css('left', translateX);
}
updateButtons();
}
// 綁定事件
$prev.on('click', function() {
if (!$(this).hasClass('disabled')) scrollTo(currentIndex - 1);
});
$next.on('click', function() {
if (!$(this).hasClass('disabled')) scrollTo(currentIndex + 1);
});
// 自動輪播
function startAuto() {
stopAuto();
autoTimer = setInterval(function() {
if (currentIndex >= maxIndex) {
scrollTo(0); // 循環回首
} else {
scrollTo(currentIndex + 1);
}
}, 3000);
}
function stopAuto() {
clearInterval(autoTimer);
}
$slider.hover(stopAuto, startAuto);
// 鍵盤支持
$(document).on('keydown', function(e) {
if (e.key === 'ArrowLeft') $prev.click();
else if (e.key === 'ArrowRight') $next.click();
});
// 觸屏滑動支持
var touchStartX = 0;
$track.on('touchstart', function(e) {
touchStartX = e.originalEvent.touches[0].clientX;
stopAuto();
}).on('touchend', function(e) {
var dx = e.originalEvent.changedTouches[0].clientX - touchStartX;
if (Math.abs(dx) > 30) {
dx < 0 ? $next.click() : $prev.click();
}
startAuto();
});
// 初始化
$track.css('position', 'relative').css('left', 0);
updateButtons();
startAuto();
// 窗口 resize 重新計算
$(window).on('resize', function() {
visibleCount = Math.floor($slider.find('.slider-viewport').width() / itemWidth);
maxIndex = Math.max(0, totalItems - visibleCount);
scrollTo(Math.min(currentIndex, maxIndex), false);
updateButtons();
});
})(jQuery);
</script>
</body>
</html>
// 初始化時克隆
var $firstClone = $items.first().clone();
var $lastClone = $items.last().clone();
$track.append($firstClone).prepend($lastClone);
$items = $track.children(); // 更新集合
currentIndex = 1; // 從第一張真實項開始
$track.css('left', -itemWidth); // 初始位置
// 滾動邏輯調整
function scrollTo(index, animate) {
// ... 動畫完成後檢查
if (index === 0) { // 滾到克隆的最後一張
setTimeout(function() {
$track.css('left', -maxIndex * itemWidth); // 瞬移到真實最後一張
currentIndex = maxIndex;
}, animate ? 400 : 0);
} else if (index === totalItems + 1) { // 滾到克隆的第一張
setTimeout(function() {
$track.css('left', -itemWidth);
currentIndex = 1;
}, animate ? 400 : 0);
}
}
這個輪播組件涵蓋了實戰中 90% 的需求:響應式、無障礙、觸屏、鍵盤、自動播放、循環。核心思想是「數據驅動索引 + CSS 動畫/JS 動畫 + 邊界狀態管理」。理解後可輕鬆擴展為分頁指示器、縮圖導航、垂直滾動、多行佈局等變體。