思維是個很奇妙的東西,一旦卡進某個死角就很難自己爬出來。通常得先把腦子冷卻一段時間,完全放下舊思路,新的出口才會浮現。
這個插件其實做的就是最常見的幻燈片輪播,只是考慮到重複使用的便利性,就把它封裝成了 jQuery 插件。
1. 各項參數高度自訂;
2. 可重複呼叫且彼此不互相干擾;
3. 體積輕巧,壓縮後僅 1.04k,未壓縮開發版 3.29k。
第一步:引入 jQuery 與插件本身。若頁面已有其他 js 檔,可合併以減少 HTTP 請求次數,引入位置自訂。
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.4/jquery.min.js"></script> <script src="js/jquery.iFadeSldie.pack.js"></script>
樣式檔不必另外引入,若沿用 DEMO 的結構,直接把樣式併進頁面即可,但更建議依自身設計重新定義。
第二步:在頁面中呼叫插件並傳入參數。未傳入或傳空值的參數,一律採用插件內的預設值。以下是 DEMO 中的三組呼叫:
$(function(){
//SAMPLE-A:不傳任何參數,全部使用預設值
$('div#slide').iFadeSlide();
//SAMPLE-B:傳入新參數,會覆蓋同名預設值
$('div#slide_b').iFadeSlide({
field: $('div#slide_b a'),
icocon: $('div.ico_b'),
hoverCls: 'high_b',
curIndex: 2, //索引值從 0 起算,此處指第 3 項高亮
interval: 2000
});
//SAMPLE-C:傳入新參數,會覆蓋同名預設值
$('div#slide_c').iFadeSlide({
field: $('div#slide_c img'),
icocon: $('div.ico_c'),
outTime: 100,
inTime: 200
});
});
要注意的是,呼叫插件的區塊必須放在插件檔案引用之後,否則會找不到方法。
;(function($){
$.fn.extend({
iFadeSlide: function(options){
//插件參數初始化
var iset = {
field: $('div#slide img'), //切換元素集合
icocon: $('div.ico'), //索引容器
hoverCls: 'high', //當前索引的高亮樣式
curIndex: 0, //預設高亮的索引值,從 0 起算
outTime: 200, //淡出時間(ms)
inTime: 300, //淡入時間(ms)
interval: 3000 //切換間隔(ms)
};
options = options || {};
$.extend(iset, options); //合併參數,options 有值則覆蓋,否則用預設
//依切換元素數量產生索引列表並插入容器
var ulcon = "<ul>";
iset.field.each(function(i){
ulcon = ulcon + '<li>' + (i + 1) + '</li>';
});
ulcon += '</ul>';
iset.icocon.append(ulcon);
var ico = iset.icocon.find('li'); //索引列表集合
var size = iset.field.size(); //切換元素數量
var index = 0; //初始索引值
var clearFun = null;
//淡出淡入函數
var fadeFun = function(obj){
index = ico.index(obj); //取當前索引值
//淡出目前可見元素,再依索引淡入目標元素
iset.field.filter(':visible').fadeOut(iset.outTime, function(){
iset.field.eq(index).fadeIn(iset.inTime);
});
//為當前索引加上高亮,並移除同層其他元素的高亮
$(obj).addClass(iset.hoverCls).siblings().removeClass(iset.hoverCls);
};
//切換函數
var changeFun = function(){
index++;
if (index == size) { index = 0; } //到底就回到 0
ico.eq(index).trigger('mouseleave'); //以觸發事件的方式呼叫 fadeFun
};
//自動切換
var scrollFun = function(){
clearFun = setInterval(function(){
changeFun()
}, iset.interval);
};
//停止自動切換
var stopFun = function(){
clearInterval(clearFun);
};
scrollFun(); //啟動自動輪播
//索引區:移入停止輪播並切到該索引,移出時回到當前索引
ico.hover(function(){
stopFun();
fadeFun(this);
}, function(){
fadeFun(this);
}).eq(iset.curIndex).mouseleave();
//切換區:移入停止輪播,移出恢復
iset.field.hover(function(){
stopFun();
}, function(){
scrollFun();
});
}
});
})(jQuery);
索引按鈕不是寫死在 HTML 裡,而是根據切換元素的數量動態產生的,所以日後增減圖片完全不用改 markup。
另一個細節是 changeFun 並沒有直接呼叫 fadeFun,而是用 trigger('mouseleave') 去觸發。這樣做的好處是自動輪播與滑鼠操作共用同一條程式路徑,行為完全一致,不必維護兩套邏輯。
最後,滑鼠移出索引區時會呼叫 fadeFun(this) 而不是重置到 0,這一步是為了讓使用者離開後畫面停留在最後看的那張,體驗上更自然。