DIV CSS 佈局教程網

Tab 選項卡插件的五個改寫階段:從全域函式到 jQuery 物件級外掛
編輯:關於JavaScript     

這次從最簡單的 Tab 選項卡切換開始,一步步把一段普通函式改寫成插件。

階段一:原生函式寫法

把方法掛到 window 全域物件上,是最省事的「插件化」。

tab.html

 <!DOCTYPE html> <html> <head lang="en"> <meta charset="UTF-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no"> <meta name="renderer" content="webkit"> <title>jquery_hjb_tab插件demo</title> <link rel="stylesheet" href="h.css"/> </head> <body> <div id="tab"> <div class="tabs"> <ul> <li><a href="#">tab1</a></li> <li><a href="#">tab2</a></li> <li><a href="#">tab3</a></li> <li><a href="#">tab4</a></li> </ul> </div> <div class="tabCons"> <section>內容一</section> <section>內容二</section> <section>內容三</section> <section>內容四</section> </div> </div> <script> window.onload = h_tab('tab'); function h_tab(tabId){ var oLinks = document.getElementById(tabId).getElementsByTagName("a"); var oCons = document.getElementById(tabId).getElementsByTagName("section"); for(var i = 0; i<oLinks.length; i++){ oLinks[i].index = i; oLinks[i].onclick = function () { for(var j =0; j<oLinks.length; j++){ oLinks[j].className=""; oCons[j].style.display = "none"; } this.className="cur"; oCons[this.index].style.display ="block"; } } } </script>

h.css

 @charset "utf-8"; /* //author:hjb2722404 //description: //date:2016/2/18 */ .tabs ul { width: 100%; list-style-type: none;} .tabs ul li { width: 48%; display: inline-block; margin: 0; padding: 0;} .tabs ul li a {border-bottom: 3px solid #cccccc; width: 100%; height: 100%; display: block; text-align: center; min-height: 40px; line-height: 40px; text-decoration: none; font-family: "微軟雅黑"; color: #a94442} .tabs ul li a.cur { border-bottom: 3px solid #f26123;} .tabCons section { display: none;} .tabCons section:nth-child(1) { display: block;}

接下來的改進都建立在這兩份程式碼上。

階段二:抽成原生插件

把函式搬到獨立檔案,並掛在 window 上:

tab.html

 …… // 下面是第一次改動 <script type="text/javascript" src="h_tabs.js"></script> <script> H_tab("tab"); </script> </body> </html>

h_tabs.js

 window.H_tab = function(tabId){ var oLinks = document.getElementById(tabId).getElementsByTagName("a"); var oCons = document.getElementById(tabId).getElementsByTagName("section"); for(var i = 0; i<oLinks.length; i++){ oLinks[i].index = i; oLinks[i].onclick = function () { for(var j =0; j<oLinks.length; j++){ oLinks[j].className=""; oCons[j].style.display = "none"; } this.className="cur"; oCons[this.index].style.display ="block"; } } };

寫法簡單,但問題也明顯:window 是全域物件,插件一多就容易命名空間衝突;另外純原生 JS 雖然沒有外部依賴,程式碼量卻不小,寫起來繁瑣。

階段三:jQuery 類級插件

jQuery 插件有三種形式:類級別、物件級別、jQuery UI 元件形式。

最直接的類級別寫法,是把方法掛到 jQuery 的根命名空間,當作工具函式:

h_tabs.js

 $.h_tab = function(tabId){ var oLinks = document.getElementById(tabId).getElementsByTagName("a"); var oCons = document.getElementById(tabId).getElementsByTagName("section"); for(var i = 0; i<oLinks.length; i++){ oLinks[i].index = i; oLinks[i].onclick = function () { for(var j =0; j<oLinks.length; j++){ oLinks[j].className=""; oCons[j].style.display = "none"; } this.className="cur"; oCons[this.index].style.display ="block"; } } };

呼叫方式:$.h_tab('tab');

若要一次掛多個方法,用 $.extend:

 $.extend({ h_tab:function(tabId){ var oLinks = document.getElementById(tabId).getElementsByTagName("a"); var oCons = document.getElementById(tabId).getElementsByTagName("section"); for(var i = 0; i<oLinks.length; i++){ oLinks[i].index = i; oLinks[i].onclick = function () { for(var j =0; j<oLinks.length; j++){ oLinks[j].className=""; oCons[j].style.display = "none"; } this.className="cur"; oCons[this.index].style.display ="block"; } } }, h_hello :function(name){ console.log("hello,",name); } });

省事歸省事,這種方式有個致命限制:用不到 jQuery 強大的 sizzle 選擇器引擎,也就是說你選到的 DOM 元素無法直接套用這個方法。所以要用物件級別的開發方式。

階段四:jQuery 物件級插件

物件級別的寫法是用 $.fn.extend() 把方法綁到 jQuery 原型上,這樣所有 jQuery 物件都能呼叫它:

h_tabs.js

 (function($){ $.fn.extend({ h_tab:function(tabId){ var oLinks = document.getElementById(tabId).getElementsByTagName('a'); var oCons = document.getElementById(tabId).getElementsByTagName('section'); for(var i = 0; i<oLinks.length; i++){ oLinks[i].index = i; oLinks[i].onclick = function () { for(var j =0; j<oLinks.length; j++){ oLinks[j].className=""; oCons[j].style.display = "none"; } this.className="cur"; oCons[this.index].style.display ="block"; } } } }); })(jQuery);

呼叫方式變成 $('#tab').h_tab('tab');。這裡用一個 IIFE 包住插件,避免污染命名空間。

不過還有個多餘的地方:既然已經用 $('#tab') 選到了元素,插件裡又靠傳入的 ID 重新取一次,明顯重複。用 this 就能省掉。

階段五:引入 this 與配置項

h_tabs.js

 (function($){ $.fn.extend({ h_tab:function(){ //在這裡引入this var oLinks = this.find('a'); var oCons = this.find('section'); for(var i = 0; i<oLinks.length; i++){ oLinks[i].index = i; oLinks[i].onclick = function () { for(var j =0; j<oLinks.length; j++){ oLinks[j].className=""; oCons[j].style.display = "none"; } this.className="cur"; oCons[this.index].style.display ="block"; } } } }); })(jQuery);

呼叫時 $('#tab').h_tab(); 即可。這裡要注意:在外掛內部,this 已經是 jQuery 物件,所以 this.find() 等價於 $('#tab').find(),而不是 $(this).find()。用代入法區分這兩種寫法,是寫 jQuery 插件最容易踩的坑。

最後,一款插件應該讓使用者能控制行為,所以要開放配置介面。這裡把「當前選項卡樣式類名」從 cur 改為 current,並作為配置項傳入:

h.css

 .tabs ul { width: 100%; list-style-type: none;} .tabs ul li { width: 48%; display: inline-block; margin: 0; padding: 0;} .tabs ul li a {border-bottom: 3px solid #cccccc; width: 100%; height: 100%; display: block; text-align: center; min-height: 40px; line-height: 40px; text-decoration: none; font-family: "微軟雅黑"; color: #a94442} /*注意下面一行與之前的樣式代碼的對比變化之處*/ .tabs ul li a.current { border-bottom: 3px solid #f26123;} .tabCons section { display: none;} .tabCons section:nth-child(1) { display: block;}

h_tabs.js

 (function($){ $.fn.extend({ //給方法傳入一個對象作為參數 h_tab:function(opts){ //定義默認的配置 var defaults ={ curName : 'cur' }; //將傳入的參數覆蓋默認參數中的默認項,最終合並到一個新的參數對象上 var Opt = $.extend({},defaults,opts); var oLinks = this.find('a'); var oCons = this.find('section'); for(var i = 0; i<oLinks.length; i++){ oLinks[i].index = i; oLinks[i].onclick = function () { for(var j =0; j<oLinks.length; j++){ oLinks[j].className=""; oCons[j].style.display = "none"; } //在這裡使用配置項的值 this.className = Opt['curName']; oCons[this.index].style.display ="block"; } } } }); })(jQuery);

$.extend({}, defaults, opts) 會把使用者傳入的設定覆蓋到預設值上,合併成一個新的設定物件——這是 jQuery 插件接受配置的標準做法。

從全域函式一路走到物件級外掛,這五個階段其實是所有 jQuery 插件的通用骨架:IIFE 隔離作用域、$.fn 擴充、this 取代重複查詢、defaults 加 $.extend 開放配置。

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