DIV CSS 佈局教程網

打造可重用輪播圖組件:Rolling 構造函數逐段解析
編輯:關於JavaScript     

這份輪播圖組件的設計目標是「可設定」:滾動幾筆、要不要焦點、到頭時要不要換圖,全部透過參數控制,不侵入頁面結構。以下逐段拆解。

 //輪播圖組件 function Rolling(o) { this.index = ++o.index || 1; //當前滾動的位置,當index大於可輪播的次數listLength或者等於0,為不可滾動狀態 this.num = o.num || 1; //默認滾動一個列表 this.obj = o.obj || null; //要輪播的對象ul this.perObj = o.perObj || null; //向上翻頁的按鈕對象 this.nextObj = o.nextObj || null; //向下翻頁的按鈕對象 this.focusPoint = o.focusPoint || null; //焦點對象,默認為null。意思不開啟焦點對象,如要開啟可傳入焦點對象可自動開啟 this.focusClass = o.focusClass || 'mien-active'; //當前焦點位置類名 this.replaceBtn = o.replaceBtn || false;//是否在輪播到第一頁或最後一頁時替換翻頁按鈕圖片。默認值為true,並替換按鈕圖片為re+圖片名。如:per.png替換成re-per.ping console.log(o.replaceBtn) this.listLength = Math.ceil(o.obj.find('li').length / this.num); //可輪播的次數 this.listObj = o.obj.children('li'); this.listWidth =this.listObj.width() + parseInt(this.listObj.css('margin-left')) + parseInt(this.listObj.css('margin-right')); //列表寬度 this.init(); //初始化 }; Rolling.prototype.init = function() { var thisObj = this; this.initLeft(); this.replaceFun(); if(this.focusPoint !== null) { this.createFocusPoint(); } this.perObj.unbind('click').on('click', function() { thisObj.rollPrev(); }); this.nextObj.unbind('click').on('click', function() { thisObj.rollNext(); }); } //創建焦點,並給當前位置的焦點添加類mien-active Rolling.prototype.createFocusPoint = function() { var str = '', thisObj = this; for(var i = 0; i < this.listLength; i++) { if(i == this.index - 1) { str += '<li class="' + this.focusClass + '"></li>'; } else { str += '<li></li>'; } } this.focusPoint.append(str); this.focusPoint.children().click(function() { var oldIndex = $('.' + thisObj.focusClass).index() + 1; //之前的焦點位置 var index = $(this).index() + 1; //當前點擊的焦點 var sum = index - oldIndex; var perObject = thisObj.perObj.find('img'); var nextObject = thisObj.nextObj.find('img'); if (index == 1 && !thisObj.replaceBtn){ perObject.attr('src',perObject.attr('data-src')); nextObject.attr('src',nextObject.attr('data-src')); }else if (index == thisObj.listLength && !thisObj.replaceBtn){ perObject.attr('src',perObject.attr('re-src')); nextObject.attr('src',nextObject.attr('re-src')); }else if (!thisObj.replaceBtn){ perObject.attr('src',perObject.attr('re-src')); nextObject.attr('src',nextObject.attr('data-src')); } thisObj.index += sum; if(sum > 0) { thisObj.obj.animate({ marginLeft: '-=' + Math.abs(sum) * thisObj.num * thisObj.listWidth + 'px' }); } if(sum < 0) { thisObj.obj.animate({ marginLeft: '+=' + Math.abs(sum) * thisObj.num * thisObj.listWidth + 'px' }); } $(this).addClass(thisObj.focusClass).siblings().removeClass(thisObj.focusClass); }); } Rolling.prototype.initLeft = function() { if(this.index == 1) { return; } this.obj.css('margin-left', -(this.index - 1) * this.listWidth); //初始化全屏圖片顯示的位置 } Rolling.prototype.rollPrev = function() { --this.index; //當點擊到第一頁就return if (this.index <= 1 && !this.replaceBtn){ this.perObj.find('img').attr('src',this.perObj.find('img').attr('data-src')); } if(!this.thisIndex()) { ++this.index; return; } if (!this.replaceBtn){ this.nextObj.find('img').attr('src',this.nextObj.find('img').attr('data-src')); } this.obj.animate({ marginLeft: '+=' + this.num * this.listWidth + 'px' }); if(this.focusPoint !== null) { $('.' + this.focusClass).removeClass(this.focusClass).prev().addClass(this.focusClass); } } Rolling.prototype.rollNext = function() { ++this.index; if (this.index == this.listLength && !this.replaceBtn){ this.nextObj.find('img').attr('src',this.nextObj.find('img').attr('re-src')); } //當點擊到最後一頁就return if(!this.thisIndex()) { --this.index; return; } if (!this.replaceBtn){ this.perObj.find('img').attr('src',this.perObj.find('img').attr('re-src')); } this.obj.animate({ marginLeft: '-=' + this.num * this.listWidth + 'px' }); if(this.focusPoint !== null) { $('.' + this.focusClass).removeClass(this.focusClass).next().addClass(this.focusClass); } } Rolling.prototype.replaceFun = function(){ var perObject = this.perObj.find('img'), nextObject = this.nextObj.find('img'); var perSrc = perObject.attr('src'), nextSrc = nextObject.attr('src'); perObject.attr({'data-src':perSrc,'re-src':this.splitSrc(perSrc)}); nextObject.attr({'data-src':nextSrc,'re-src':this.splitSrc(nextSrc)}); } Rolling.prototype.splitSrc = function(str){ var list = str.split('/'); var data = list[list.length-1]; var sub = data.substr(0,data.indexOf('.')); return str.replace(sub,'re-' + sub); } Rolling.prototype.thisIndex = function() { if(this.index > this.listLength | this.index <= 0) { return false; } return true; } function createRolling(o) { return new Rolling(o); }

幾個值得借鑑的設計

用 thisObj 保留 this。init 與 createFocusPoint 裡都有 var thisObj = this;,因為 jQuery 的事件回呼會把 this 重新指向觸發元素,直接寫 this.rollPrev() 會找不到方法。

listWidth 把 margin 算進來。寬度不只取 width(),還加上左右 margin,這樣 animate 的位移量才會與視覺上的間距一致。少了這一步,每翻一頁就會逐漸累積誤差。

replaceFun 與 splitSrc 的命名慣例。初始化時把原圖路徑存進 data-src,並依「檔名前加 re-」的規則推導出禁用狀態的圖片路徑存進 re-src。這是一種約定勝於設定的做法:設計師只要照規則命名,前端不必額外配置。

thisIndex 做邊界守門。rollPrev 與 rollNext 都先改 index,再交給 thisIndex 判斷是否越界;越界就把 index 還原並 return,動畫自然不會執行。

可以更好的地方

this.index = ++o.index || 1 這行有副作用:它直接改寫了傳進來的設定物件。若同一個設定被重複使用,第二次建立的實例起始位置會被上一次的結果影響。改成 this.index = o.index ? o.index + 1 : 1 更安全。

thisIndex() 裡的 this.index > this.listLength | this.index <= 0 用了位元或 | 而非邏輯或 ||。兩個運算式都是布林值,結果剛好正確,但這是誤用——位元運算會進行型別轉換且不再短路,遇到有副作用的條件時會出錯。

另外,這份程式碼沒有自動播放與滑鼠移入暫停,也沒有觸控手勢支援。若要用手機版,建議改用 Swiper、Embla 這類成熟方案,它們在無障礙標記(aria-label、鍵盤操作)與效能上都處理得更完整。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved