DIV CSS 佈局教程網

jQuery 插件開發:實作簡易手風琴切換效果
編輯:JQuery特效代碼     

手風琴(Accordion)適合用來做圖片牆或側邊欄的展開式導覽。這個插件可以用在圖片或任何容器上,呼叫方式與一般 jQuery 插件無異,原理也不複雜,關鍵都在動畫的位移計算上。

一、插件程式碼

;(function($){
  /**
   * 基於 jQuery 的簡易手風琴切換插件
   */
  $.fn.iAccordion = function(iSet){
    var self = this;
    iSet = $.extend({
      Type: 'mouseover',      // 觸發事件:mouseover、click、mouseleave 等
      Select: 'img',          // 選擇器,用來取得要切換的元素集合
      Cur: 0,                 // 預設展開元素的索引
      InitInterval: 100,      // 初始化手風琴動畫的間隔
      Interval: 500,          // 事件觸發時的動畫間隔
      Easing: ''              // 動畫 easing,需 jQuery.easing 支援
    }, iSet || {});

    var item, boxW, selectW, animateW, sIndex, animateL;

    $(self).each(function(){
      // 初始化容器樣式
      $(this).css({ 'position': 'relative', 'overflow': 'hidden' });

      item = $(this).find(iSet.Select);

      // 初始化切換元素樣式:全部疊在同一個起點
      item.css({ 'position': 'absolute', 'left': 0, 'top': 0 });

      boxW     = $(this).outerWidth();          // 容器總寬
      selectW  = item.outerWidth();             // 展開時的寬度
      animateW = (boxW - selectW) / (item.size() - 1);   // 收合狀態下每格可見寬度

      // 初始化排列,並為每個元素寫入索引
      item.each(function(i){
        $(this).animate({ 'left': animateW * i + 'px' }, iSet.InitInterval, iSet.Easing);
        $(this).data('index', i);
      }).on(iSet.Type, function(e){
        // 取得當前元素索引
        sIndex = $(this).data('index');

        // 依索引大小關係決定位移:展開當前元素,其餘依序排列
        item.each(function(n){
          n > sIndex ? animateL = selectW + animateW * (n - 1)
                     : animateL = animateW * n;
          $(this).stop().animate({ 'left': animateL + 'px' }, iSet.Interval, iSet.Easing);
        });
      }).eq(iSet.Cur).trigger(iSet.Type);        // 觸發預設展開項
    });
  }
})(jQuery);

二、如何呼叫

  1. 在頁面中引入 jQuery 與上面的插件程式碼。
  2. 呼叫:$(selectmain).iAccordion({ ... });
  3. 相關參數與功能請參考插件中的註解說明。

使用範例:

$(function(){
  // 基本用法:以圖片為切換元素,預設展開第 3 張
  $('#box').iAccordion({
    Select: 'img',
    Cur: 2,
    Type: 'click',
    Interval: 400
  });
});

三、位移計算怎麼來

整個效果建立在一個簡單的等式上:

animateW = (容器寬 - 展開寬) / (元素數量 - 1)

意思是:一張全展開時佔掉 selectW,剩下的空間要平均分給其他 n-1 張,所以每張只露出 animateW 寬度。接著在切換時,針對每個元素判斷它排在「當前展開項」的前面還是後面:

  • 排在後面(n > sIndex):左移量要額外加上展開寬 selectW,才不會被蓋住。
  • 排在前面:維持 animateW * n 即可。

這個「加不加 selectW」的判斷,就是手風琴視覺效果的來源。

四、小提醒

  • 若要使用 Easing 參數,必須另外引入 jQuery.easing 插件,參數值即 easing 的方法名稱,例如 easeOutBounce、easeOutQuint。
  • 每個元素上的 .stop() 不可省略,否則連續快速切換會導致動畫堆疊、畫面落後。
  • 容器務必設 overflow: hidden,收合的內容才不會溢出顯示。
  • 插件中的 .size() 在 jQuery 3 已移除,改寫時請替換為 .length;.on() 與 .data() 則可繼續沿用。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved