Element.scrollLeft 讀取/設定元素水平捲動位置 (像素)。結合 scrollWidth、clientWidth 即可計算捲動邊界與比例,實現按鈕逐幀/頁切換、捲軸拖曳同步。
<div class="album-wrapper">
<button class="btn-prev" aria-label="上一頁">‹</button>
<div class="viewport" id="viewport">
<ul class="track" id="track">
<li><img src="1.jpg" alt=""></li>
<li><img src="2.jpg" alt=""></li>
...
</ul>
</div>
<button class="btn-next" aria-label="下一頁">›</button>
<!-- 自訂捲軸 (可選) -->
<div class="scrollbar">
<div class="track"><div class="thumb" id="scrollThumb"></div></div>
</div>
</div>
.album-wrapper { position: relative; width: 980px; margin: 0 auto; }
.viewport { overflow-x: hidden; white-space: nowrap; } /* 隱藏原生捲軸 */
.track { display: inline-block; white-space: nowrap; font-size: 0; transition: transform 0.3s ease; }
.track li { display: inline-block; width: 220px; margin-right: 20px; vertical-align: top; }
.btn-prev, .btn-next { position: absolute; top: 50%; transform: translateY(-50%); width: 40px; height: 80px; background: rgba(0,0,0,0.4); color: #fff; border: none; font-size: 30px; cursor: pointer; opacity: 0; transition: opacity 0.2s; z-index: 10; }
.btn-prev { left: 0; } .btn-next { right: 0; }
.album-wrapper:hover .btn-prev, .album-wrapper:hover .btn-next { opacity: 1; }
/* 自訂捲軸樣式 */
.scrollbar { height: 12px; margin-top: 10px; }
.scrollbar .track { height: 6px; background: #eee; border-radius: 3px; position: relative; }
.scrollbar .thumb { position: absolute; top: -3px; height: 12px; background: #333; border-radius: 6px; cursor: pointer; min-width: 30px; }
var viewport = document.getElementById('viewport');
var track = document.getElementById('track');
var thumb = document.getElementById('scrollThumb');
var itemWidth = 240; // li 寬度 + margin
var visibleCount = 4; // 可視數量
var totalItems = track.children.length;
var maxScroll = track.scrollWidth - viewport.clientWidth;
// === 按鈕控制 ===
document.querySelector('.btn-prev').addEventListener('click', function() {
viewport.scrollLeft = Math.max(0, viewport.scrollLeft - itemWidth * visibleCount);
// 或平滑捲動:viewport.scrollBy({left: -itemWidth*visibleCount, behavior:'smooth'});
});
document.querySelector('.btn-next').addEventListener('click', function() {
viewport.scrollLeft = Math.min(maxScroll, viewport.scrollLeft + itemWidth * visibleCount);
});
// === 內容捲動同步捲軸 ===
viewport.addEventListener('scroll', function() {
if (maxScroll <= 0) return; // 內容未超出
var ratio = viewport.scrollLeft / maxScroll;
var thumbMaxLeft = this.querySelector('.scrollbar .track').clientWidth - thumb.clientWidth;
thumb.style.left = ratio * thumbMaxLeft + 'px';
});
// === 拖曳捲軸控制內容 ===
thumb.addEventListener('mousedown', function(e) {
var startX = e.clientX;
var startLeft = parseInt(this.style.left) || 0;
var thumbTrack = this.parentElement;
var thumbMaxLeft = thumbTrack.clientWidth - this.clientWidth;
function onMove(e) {
var dx = e.clientX - startX;
var newLeft = Math.max(0, Math.min(thumbMaxLeft, startLeft + dx));
thumb.style.left = newLeft + 'px';
var ratio = newLeft / thumbMaxLeft;
viewport.scrollLeft = ratio * maxScroll;
}
function onUp() {
document.removeEventListener('mousemove', onMove);
document.removeEventListener('mouseup', onUp);
}
document.addEventListener('mousemove', onMove);
document.addEventListener('mouseup', onUp);
e.preventDefault();
});
// === 響應式:resize 重算 ===
window.addEventListener('resize', function() {
maxScroll = track.scrollWidth - viewport.clientWidth;
// 可視數量可能變化,重新計算 itemWidth 等
});
// 平滑捲動 (現代瀏覽器)
viewport.scrollBy({ left: -itemWidth * visibleCount, behavior: 'smooth' });
// 鍵盤左右鍵
viewport.setAttribute('tabindex', '0'); // 使其可聚焦
viewport.addEventListener('keydown', function(e) {
if (e.key === 'ArrowLeft') { viewport.scrollBy({left: -itemWidth, behavior:'smooth'}); e.preventDefault(); }
if (e.key === 'ArrowRight') { viewport.scrollBy({left: itemWidth, behavior:'smooth'}); e.preventDefault(); }
});
.viewport {
overflow-x: auto;
scroll-snap-type: x mandatory;
-webkit-overflow-scrolling: touch;
/* 捲軸美化 */
scrollbar-width: thin;
scrollbar-color: #333 transparent;
}
.track {
display: flex;
gap: 20px;
}
.track li {
flex: 0 0 220px;
scroll-snap-align: start;
}
瀏覽器自動處理捕捉對齊、動量滾動、觸控慣性。配合 ::-webkit-scrollbar 美化捲軸,完全取代 JS 實作。
scrollLeft 是控制水平捲動的核心 API。按鈕控制、捲軸同步、拖曳反向控制三者構成完整交互閉環。現代專案優先採用 CSS Scroll Snap + 原生捲軸,僅在需要極度客製化捲軸 UI 或舊瀏覽器相容時才自行實作。