萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

scrollLeft 實作按鈕控制圖片相簿:帶捲軸同步的橫向輪播完整教學

核心原理

Element.scrollLeft 讀取/設定元素水平捲動位置 (像素)。結合 scrollWidth、clientWidth 即可計算捲動邊界與比例,實現按鈕逐幀/頁切換、捲軸拖曳同步。

HTML 結構

<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>

CSS 關鍵樣式

.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; }

JavaScript 核心邏輯

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(); }
});

現代 CSS Scroll Snap 方案 (零 JS)

.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 或舊瀏覽器相容時才自行實作。

copyright © 萬盛學電腦網 all rights reserved