萬盛學電腦網

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

jQuery 圖文自動輪播插件實現:無縫切換、縮圖導航、標題描述動畫

功能特性

  • 大圖自動輪播,支持鼠標懸停暫停
  • 縮圖導航:點擊切換、當前態高亮、懸停效果
  • 標題描述區域:淡入淡出動畫、高度自適應
  • 標題欄收起/展開切換
  • 響應式佈局兼容

HTML 結構

<div class="main_image">
  <img src="img/1.jpg" alt="圖片1標題" />
  <div class="block">
    <a href="link1.html" class="collapse">收起</a>
    <h3><a href="link1.html">圖片1標題</a></h3>
    <p>圖片1描述內容...</p>
  </div>
</div>

<div class="image_thumb">
  <ul>
    <li><img src="thumb/1.jpg" alt="圖片1標題" /><a href="img/1.jpg"></a><div class="block">描述1</div></li>
    <li><img src="thumb/2.jpg" alt="圖片2標題" /><a href="img/2.jpg"></a><div class="block">描述2</div></li>
    <li><img src="thumb/3.jpg" alt="圖片3標題" /><a href="img/3.jpg"></a><div class="block">描述3</div></li>
  </ul>
</div>

CSS 關鍵樣式

.main_image { position: relative; overflow: hidden; width: 100%; height: 400px; }
.main_image img { position: absolute; top: 0; left: 0; width: 100%; height: 100%; object-fit: cover; }
.main_image .block { position: absolute; bottom: 0; left: 0; right: 0; background: rgba(0,0,0,0.6); color: #fff; padding: 20px; }
.main_image .block h3 { margin: 0 0 10px; }
.main_image .block a.collapse { float: right; color: #fff; cursor: pointer; }

.image_thumb ul { display: flex; gap: 10px; list-style: none; padding: 10px; overflow-x: auto; }
.image_thumb li { cursor: pointer; position: relative; width: 120px; height: 80px; flex-shrink: 0; border: 2px solid transparent; }
.image_thumb li.active { border-color: #007bff; }
.image_thumb li.hover { border-color: #28a745; }
.image_thumb img { width: 100%; height: 100%; object-fit: cover; }
.image_thumb .block { display: none; } /* 縮圖中的描述數據,供 JS 讀取 */

核心 JS 實現

(function($) {
  $.fn.imageCarousel = function(options) {
    var opts = $.extend({
      interval: 3000,        // 輪播間隔(ms)
      fadeSpeed: 250,        // 淡入淡出速度
      descSpeed: 250         // 描述動畫速度
    }, options);
    
    return this.each(function() {
      var $container = $(this);
      var $mainImg = $container.find('.main_image img');
      var $mainDesc = $container.find('.main_image .block');
      var $thumbs = $container.find('.image_thumb ul li');
      var $collapseBtn = $mainDesc.find('.collapse');
      var timer = null;
      var currentIndex = 0;
      var total = $thumbs.length;
      
      // 初始化
      function init() {
        $thumbs.first().addClass('active');
        showDesc(0);
        startAutoPlay();
        bindEvents();
      }
      
      // 顯示指定索引的圖片與描述
      function showDesc(index) {
        var $thumb = $thumbs.eq(index);
        var imgSrc = $thumb.find('a').attr('href');
        var imgAlt = $thumb.find('img').attr('alt');
        var descHtml = $thumb.find('.block').html();
        var descHeight = $mainDesc.height();
        
        // 更新縮圖狀態
        $thumbs.removeClass('active').eq(index).addClass('active');
        
        // 大圖切換(簡單 src 替換,可擴展為淡入淡出)
        $mainImg.attr({ src: imgSrc, alt: imgAlt });
        
        // 描述動畫:淡出 -> 替換內容 -> 淡入
        $mainDesc.animate({ opacity: 0, marginBottom: -descHeight }, opts.fadeSpeed, function() {
          $(this).html(descHtml).animate({ opacity: 0.85, marginBottom: 0 }, opts.descSpeed);
        });
      }
      
      // 自動播放
      function startAutoPlay() {
        stopAutoPlay();
        timer = setInterval(nextSlide, opts.interval);
      }
      
      function stopAutoPlay() {
        clearInterval(timer);
      }
      
      function nextSlide() {
        currentIndex = (currentIndex + 1) % total;
        showDesc(currentIndex);
      }
      
      // 事件綁定
      function bindEvents() {
        // 縮圖點擊
        $thumbs.click(function(e) {
          e.preventDefault();
          if ($(this).hasClass('active')) return;
          currentIndex = $thumbs.index(this);
          showDesc(currentIndex);
        }).hover(
          function() { $(this).addClass('hover'); },
          function() { $(this).removeClass('hover'); }
        );
        
        // 主圖區域懸停暫停
        $container.find('.main_image').hover(stopAutoPlay, startAutoPlay);
        
        // 描述收起/展開
        $collapseBtn.click(function(e) {
          e.preventDefault();
          $mainDesc.slideToggle();
          $(this).toggleClass('show').text($(this).hasClass('show') ? '展開' : '收起');
        });
      }
      
      init();
    });
  };
})(jQuery);

// 初始化調用
$(function() {
  $('#carouselContainer').imageCarousel({ interval: 4000 });
});

進階擴展建議

  1. 觸摸滑動支持:集成 hammer.js 或原生 touchstart/move/end 實現移動端左右滑動切換
  2. 圖片懶加載:縮圖 data-src,可視區進入時賦值 src
  3. 鍵盤導航:keydown 監聽左/右鍵切換
  4. 進度條指示器:頂部細條動畫顯示倒計時
  5. 無縫循環:克隆首尾節點實現真正無限輪播(當前為跳轉式)

總結

本插件採用模塊化封裝、配置選項化、事件解耦的設計模式,核心邏輯集中在 showDesc 統一渲染函數。通過縮圖 .block 存儲描述數據,實現「數據與視圖分離」。代碼結構清晰,易於維護與功能擴展,可直接用於生產環境或作為學習 jQuery 插件開發的範例。

copyright © 萬盛學電腦網 all rights reserved