本文記錄了一次為 Carousel 輪播插件擴充新功能的實踐過程,同時也整理成教學影片供大家參考。核心目標很直觀:當滑鼠懸停或點擊下方的切換按鈕時,輪播會立刻跳到與該按鈕對應下標的那一幀作為首屏顯示。
完整的原始碼都放在這裡:
https://github.com/wwervin72/jQuery-Carousel
既然想清楚了要做什麼,那就直接動手。第一步自然是把這些切換按鈕渲染出來,因此我們需要在 Carousel 的原型物件 prototype 上掛一個方法,專門負責生成幻燈片切換按鈕。
switchSlideBtn : function(){ var slideNum = this.posterItems.size(); //獲得當前的這個carousel對象的總共的幀數 var str = ''; var firstBtnLeft = (this.setting.width-(slideNum-1)*15-slideNum*15)/2; //規定第一個按鈕放的位置 for(var i = 0; i<slideNum; i++){ str += '<button class="btn"></button>'; //把每一個btn的代碼添加到str字符串中,然後一次性添加到selBtn這裡面,避免多次修改DOM } $('#selBtn').html(str); for(var i = 0;i<slideNum; i++){ $('#selBtn .btn').eq(i).css('left' , firstBtnLeft+i*30); } }, 寫好方法之後,別忘了在 Carousel 的建構函式裡呼叫它,按鈕才會真正出現在頁面上。
this.switchSlideBtn();
走到這一步,選擇按鈕已經就位。接下來要做的,是替每顆按鈕綁上滑鼠移入的行為。
$('#selBtn .btn').each(function(){ $(this).hover(function(){ if(self.rotateFlag){ self.switchSlide(this); } },function(){ }); })隨後我們還得替 Carousel 的原型物件補上一個切換幻燈片的方法。由於 HTML 結構裡每一幀都是放著 a、img 的 li,因此這些 li 就對應著 Carousel 的每一幀。
//用切換幻燈片的按鈕切換幻燈片的方法 switchSlide : function(btn){ var self = this; var BtnIndex = $(btn).index(); //獲得當前是哪一個按鈕執行事件 $('#selBtn .btn').css('background','rgba(255,255,255,.3)'); $('#selBtn .btn').eq(BtnIndex).css('background','rgba(255,255,255,1)'); var level = Math.floor(this.posterItems.size()/2), posterItemsLength = this.posterItems.size(), index; $('.poster-item').filter(function(i,item){ if($(this).css('z-index') == level){ //獲得當前顯示的第一幀的下標 index = i; } }); var nextTime = BtnIndex-index; //向左旋轉nextTime次 var arr = [],zIndexArr=[]; for(var i = 0;i < posterItemsLength;i++){ arr.push(i); } arr = arr.concat(arr); //添加一個數組,用來模擬Li的下標 if(nextTime > 0){ //prev 左旋轉,把數組的後半部分向前移動nextTime個下標 self.rotateFlag = false; //注意這裡吧self.rotateFlag這個標識放在裡面來修改了。 this.posterItems.each(function(i, item){ var posterItemIndex = arr.lastIndexOf(i); //獲得li節點在arr中對應的下標 var tag = $(self.posterItems[arr[posterItemIndex-nextTime]]), width = tag.width(), height = tag.height(), zIndex = tag.css('zIndex'), opacity = tag.css('opacity'), left = tag.css('left'), top = tag.css('top'); zIndexArr.push(zIndex); $(item).animate({ width : width, height : height, opacity : opacity, left : left, top : top },self.setting.speed,function(){ self.rotateFlag = true; //在每一個幀的動畫都執行完畢之後,self.rotateFlag改為true,才能執行下一次動畫 }); }); self.posterItems.each(function(i){ $(this).css('zIndex',zIndexArr[i]); //把這個z-index提出來單獨改變是為了讓z-index這個屬性的改變最先執行,並且不需要動畫 }); } if(nextTime < 0){ //next 右旋轉,把數組的前半部分向後移動nextTime的絕對值個下標 self.rotateFlag = false; this.posterItems.each(function(i, item){ var posterItemIndex = arr.indexOf(i), //獲得li節點在arr中對應的下標 tag = $(self.posterItems[arr[posterItemIndex+Math.abs(nextTime)]]), width = tag.width(), height = tag.height(), zIndex = tag.css('zIndex'), opacity = tag.css('opacity'), left = tag.css('left'), top = tag.css('top'); zIndexArr.push(zIndex); $(item).animate({ width : width, height : height, opacity : opacity, left : left, top : top },self.setting.speed,function(){ self.rotateFlag = true; }); }); self.posterItems.each(function(i){ $(this).css('zIndex',zIndexArr[i]); }); } },整個過程中主要卡在兩個難題上:
1、如何取得每一幀移動之後的新下標,再把對應下標的屬性套回對應的幀上。
我的做法是依照 li 的長度建立一個元素為 0 到 li.length-1 的陣列,然後 concat 自身一次,用裡面的元素來標記每一幀旋轉後的下標。若輪播需要左旋(也就是按鈕下標大於目前首幀下標),就取陣列後半段當作各幀的新下標,並向左位移(按鈕下標減去首幀下標)個位置,落在該位置的元素即為旋轉後的下標;右旋的邏輯類似,只是改為把陣列前半段往後移動。
2、當滑鼠在按鈕上飛快劃過時會冒出一些 BUG,原因在於上一段動畫還沒跑完,下一個事件就又被觸發了。
這裡需要一個開關來約束事件觸發,也就是 self.rotateFlag。不過多次測試後發現,把這個標記設為 false 的語句如果放在旋轉方法之前反而會出問題;把它移到方法內部 if 判斷的開頭,基本上就穩定了。
至此,Carousel 的擴充功能就介紹完了。其他細節就不再贅述,有興趣的朋友可以從上面的網址下載原始碼研究,也感謝大家一路以來的支持!