輪播這個需求做過幾次之後,每次都重寫一遍實在沒道理,於是就把它包成插件。
樣式檔不必另外引入;若沿用範例的結構,直接把樣式併進頁面即可,但更建議依自己的設計稿重寫。
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.4/jquery.min.js"></script> <script src="js/jquery.iFadeSldie.pack.js"></script>
若頁面上已有其他自建腳本,可以合併以減少 HTTP 請求。
$(function(){
// A:不傳任何參數,全部使用預設
$('div#slide').iFadeSlide();
// B:只覆寫部分參數,其餘沿用預設
$('div#slide_b').iFadeSlide({
field: $('div#slide_b a'),
icocon: $('div.ico_b'),
hoverCls: 'high_b',
curIndex: 2, // 索引從 0 起算,此處指第三項
interval: 2000
});
// 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, // 淡出毫秒
inTime: 300, // 淡入毫秒
interval: 3000 // 自動切換間隔毫秒
};
options = options || {};
$.extend(iset, 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);
};
// 索引前進,到底就回到 0
var changeFun = function(){
index++;
if (index == size) index = 0;
ico.eq(index).trigger('mouseleave');
};
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);
索引的滑出回呼之所以又呼叫一次 fadeFun,是為了把 index 同步回目前滑鼠所在的那一項;否則滑出之後自動輪播會從錯誤的位置接續,看起來就是亂跳。
淡出與淡入並沒有重疊:先等 fadeOut 的 callback 觸發,才啟動 fadeIn。這樣做的視覺節奏比較穩,代價是切換總耗時等於 outTime 加 inTime,若想要交錯效果則需改寫這段邏輯。
另外,範例中的 .size() 在 jQuery 3.x 已被移除,請改用 .length;interval 與 hover 暫停的組合在實務上很實用,能大幅降低誤觸帶來的困擾。
本插件可自由使用,包含任何形式的商業用途,但使用時請保留版權歸屬聲明。歡迎提出問題與建議。
測試檔打包下載:https://xiazai.jb51.net/201008/yuanma/jQuery_iFadeSlide.rar