萬盛學電腦網

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

jQuery 圖片輪播插件開發全解析:從零構建可配置、可擴展的 Slider 組件

插件架構設計

;(function($) {
  // 1. 默認配置
  const DEFAULTS = {
    width: 500,
    height: 300,
    showTitle: true,
    interval: 3000,
    animation: 'fade', // fade | slide | none
    autoPlay: true,
    pauseOnHover: true,
    navigation: true,  // 分頁器
    arrows: true,      // 上下箭頭
    cssLink: ''        // 外部樣式
  };
  
  // 2. 構造函數
  class Slider {
    constructor(element, options) {
      this.$el = $(element);
      this.opts = $.extend({}, DEFAULTS, options);
      this.current = 0;
      this.timer = null;
      this.$slides = this.$el.find('.slider-list li');
      this.count = this.$slides.length;
      this.init();
    }
    
    init() {
      this.setupDOM();
      this.bindEvents();
      this.loadCSS();
      if (this.opts.autoPlay) this.startAutoPlay();
    }
    
    setupDOM() {
      // 容器樣式
      this.$el.css({width: this.opts.width, height: this.opts.height, position: 'relative', overflow: 'hidden'});
      this.$slides.css({position: 'absolute', top: 0, left: 0, width: '100%', height: '100%', display: 'none'})
        .eq(0).show();
      
      // 生成導航
      if (this.opts.navigation) this.createNavigation();
      if (this.opts.arrows) this.createArrows();
      if (this.opts.showTitle) this.createTitle();
    }
    
    createNavigation() {
      this.$nav = $('
    ').appendTo(this.$el); this.$slides.each((i, slide) => { const title = $(slide).find('img').attr('alt') || i + 1; $('
  • ').text(title).appendTo(this.$nav); }); this.$navItems = this.$nav.find('li').eq(0).addClass('active').end(); } // ... 省略 createArrows, createTitle, bindEvents, loadCSS 等方法 goTo(index) { if (index < 0) index = this.count - 1; if (index >= this.count) index = 0; if (index === this.current) return; this.$slides.eq(this.current).fadeOut(300); this.$slides.eq(index).fadeIn(300); this.updateNav(index); this.current = index; } next() { this.goTo(this.current + 1); } prev() { this.goTo(this.current - 1); } startAutoPlay() { this.timer = setInterval(() => this.next(), this.opts.interval); } stopAutoPlay() { clearInterval(this.timer); this.timer = null; } destroy() { this.stopAutoPlay(); this.$el.off('.slider'); this.$nav?.remove(); this.$arrows?.remove(); this.$title?.remove(); this.$el.removeData('slider'); } } // 3. jQuery 插件橋接 $.fn.imgSlider = function(options) { return this.each(function() { if (!$.data(this, 'slider')) { $.data(this, 'slider', new Slider(this, options)); } }); }; // 4. 公開 API 訪問 $.fn.imgSlider.getInstance = function(el) { return $(el).data('slider'); }; })(jQuery);

    HTML 結構規範

    <div id="banner" class="slider">
      <ul class="slider-list">
        <li><img src="1.jpg" alt="標題一"></li>
        <li><img src="2.jpg" alt="標題二"></li>
        <li><img src="3.jpg" alt="標題三"></li>
      </ul>
    </div>
    
    <script>
    $('#banner').imgSlider({
      width: 800,
      height: 400,
      interval: 5000,
      animation: 'slide'
    });
    
    // 外部控制
    const slider = $('#banner').imgSlider.getInstance('#banner');
    slider.goTo(2);
    slider.stopAutoPlay();
    </script>

    進階功能擴展

    • 觸摸滑動:集成 Hammer.js 或原生 touch 事件,支持手機滑動切換
    • 懶加載:data-src 屬性,可視區域加載
    • 動畫類型:CSS Transition/Animation 替代 jQuery animate,啟用 GPU 加速
    • 無障礙:ARIA roles、鍵盤導航、螢幕閱讀器支持
    • 響應式:window.resize 重新計算尺寸,圖片 srcset 適配

    現代化重寫方向

    // ES Module + Web Component 版本
    class ImgSlider extends HTMLElement {
      static get observedAttributes() { return ['width', 'height', 'interval']; }
      constructor() { super(); this.attachShadow({mode: 'open'}); }
      connectedCallback() { this.render(); this.init(); }
      // ...
    }
    customElements.define('img-slider', ImgSlider);
    copyright © 萬盛學電腦網 all rights reserved