手風琴(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);
$(selectmain).iAccordion({ ... });使用範例:
$(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() 則可繼續沿用。