萬盛學電腦網

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

jQuery 實現圖片列表左右箭頭無縫滾動輪播完整實例

效果預覽

固定寬度容器顯示 N 張圖片,左右箭頭點擊滾動一屏或單張,支持自動輪播、鼠標懸停暫停、循環無縫、響應式適配。

完整 HTML + CSS + JS

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

核心邏輯解析

  1. Flex 佈局 + transform/left 動畫:`slider-track` 使用 `display: flex` 自然排列項目,動畫修改 `left` 或 `transform: translateX()` 實現滾動。
  2. 可視數量動態計算:`visibleCount = viewportWidth / itemWidth`,響應式自適應。
  3. 邊界控制:`maxIndex = total - visibleCount`,禁止超出範圍滾動。
  4. 狀態鎖 `isAnimating`**:防止動畫未完成時重複觸發。
  5. 無縫循環:到達末尾自動跳回首張(或克隆首尾節點實現真無縫,此處簡化為跳回)。
  6. 多交互融合**:點擊、鍵盤、觸屏、自動播放、懸停暫停、resize 重算。

進階:真·無縫循環(克隆首尾)


// 初始化時克隆
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 動畫 + 邊界狀態管理」。理解後可輕鬆擴展為分頁指示器、縮圖導航、垂直滾動、多行佈局等變體。

copyright © 萬盛學電腦網 all rights reserved