這次帶給大家jQuery外掛封裝步驟詳解,jQuery外掛程式封裝的注意事項有哪些,下面就是實戰案例,一起來看一下。
擴充jQuery外掛和方法的作用是非常強大的,它可以節省大量開發時間。這篇文章將概述jQuery插件開發的基本知識,最佳做法和常見的陷阱。
一、入門
編寫一個jQuery外掛程式開始於給jQuery.fn加入新的功能屬性,此處新增的物件屬性的名稱就是你外掛的名稱:
. 程式碼如下:
jQuery.fn.myPlugin = function(){ //你自己的插件代码 };
使用者非常喜歡的符號哪裡去了?它仍然存在,但是,為了避免和其他JavaScript庫衝突,我們最好將jQuery傳遞給一個自我執行的封閉程序,jQuery在此程序中映射為符號,這樣可以避免$號被其他庫覆寫。
. 程式碼如下:
(function ($) { $.fn.myPlugin = function () { //你自己的插件代码 }; })(jQuery);
在這個封閉程式中,我們可以無限制的使用$符號來表示jQuery函數。
二、環境
現在,我們可以開始寫實際的外掛程式碼。但是,在這之前,我們必須要對插件所處的環境有個概念。在插件的範圍裡, this關鍵字代表了這個插件將要執行的jQuery對象, 這裡容易產生一個普遍的誤區,因為在其他包含callback的jQuery函數中,this關鍵字代表了原生的DOM元素。這常常會導致開發者誤將this關鍵字無謂的包在jQuery中,如下所示。
. 程式碼如下:
(function ($) { $.fn.myPlugin = function () { //此处没有必要将this包在$号中如$(this),因为this已经是一个jQuery对象。 //$(this)等同于 $($('#element')); this.fadeIn('normal', function () { //此处callback函数中this关键字代表一个DOM元素 }); }; })(jQuery); $('#element').myPlugin();
三、基礎知識
現在,我們了解jQuery外掛的基礎知識,讓我們寫一個插件,做一些事情。
. 程式碼如下:
(function ($) { $.fn.maxHeight = function () { var max = 0; this.each(function () { max = Math.max(max, $(this).height()); }); return max; }; })(jQuery); var tallest = $('p').maxHeight(); //返回高度最大的p元素的高度
這是一個簡單的插件,利用.height()返回頁面中高度最大的p元素的高度。
四、維護Chainability
很多時候,一個外掛程式的意圖只是以某種方式修改收集的元素,並把它們傳遞給鏈中的下一個方法。這是jQuery的設計之美,也是jQuery如此受歡迎的原因之一。因此,要保持一個插件的chainability,你必須確保你的插件回到this關鍵字。
. 程式碼如下:
(function ($) { $.fn.lockDimensions = function (type) { return this.each(function () { var $this = $(this); if (!type || type == 'width') { $this.width($this.width()); } if (!type || type == 'height') { $this.height($this.height()); } }); }; })(jQuery); $('p').lockDimensions('width').CSS('color', 'red');
由於外掛程式返回this關鍵字,它保持了chainability,這樣jQuery收集的元素可以繼續被jQuery方法如.css控制。因此,如果你的外掛不回傳固有的價值,你應該總是在其作用範圍內回傳this關鍵字。此外,你可能會推斷出,傳遞給插件的參數將會在插件的作用範圍內傳遞。因此,在前面的例子,字串'width'變成了插件的類型參數。
五、預設值和選項
對於比較複雜的和提供了許多選項可自訂的的插件,最好有一個當插件被呼叫的時候可以被拓展的預設設定(透過使用$.extend)。因此,相對於呼叫一個有大量參數的插件,你可以呼叫一個物件參數,包含你了你想覆寫的設定。
. 程式碼如下:
(function ($) { $.fn.tooltip = function (options) { //创建一些默认值,拓展任何被提供的选项 var settings = $.extend({ 'location': 'top', 'background-color': 'blue' }, options); return this.each(function () { // Tooltip插件代码 }); }; })(jQuery); $('p').tooltip({ 'location': 'left' });
在這個範例中,呼叫tooltip外掛程式時覆寫了預設設定中的location選項,background-color選項保持預設值,所以最終被呼叫的設定值為:
. 程式碼如下:
{ 'location': 'left', 'background-color': 'blue' }
這是一個很靈活的方式,提供一個高度可配置的插件,而無需開發人員定義所有可用的選項。
六、命名空間
#正確命名空間你的外掛程式是外掛程式開發的一個非常重要的一部分。正確的命名空間,可以確保你的外掛程式將有一個非常低的機會被其他外掛程式或同一頁上的其他程式碼覆蓋。命名空間也使得你的生活作為一個插件開發人員更容易,因為它可以幫助你更好地追蹤你的方法,事件和數據。
七、外掛方法
#在任何情况下,一个单独的插件不应该在jQuery.fnjQuery.fn对象里有多个命名空间。
. 代码如下:
(function ($) { $.fn.tooltip = function (options) { // this }; $.fn.tooltipShow = function () { // is }; $.fn.tooltipHide = function () { // bad }; $.fn.tooltipUpdate = function (content) { // !!! }; })(jQuery);
这是不被鼓励的,因为它.fn使.fn命名空间混乱。 为了解决这个问题,你应该收集对象文本中的所有插件的方法,通过传递该方法的字符串名称给插件以调用它们。
. 代码如下:
(function ($) { var methods = { init: function (options) { // this }, show: function () { // is }, hide: function () { // good }, update: function (content) { // !!! } }; $.fn.tooltip = function (method) { // 方法调用 if (methods[method]) { return methods[method].apply(this, Array.prototype.slice.call(arguments, 1)); } else if (typeof method === 'object' || !method) { return methods.init.apply(this, arguments); } else { $.error('Method' + method + 'does not exist on jQuery.tooltip'); } }; })(jQuery); //调用init方法 $('p').tooltip(); //调用init方法 $('p').tooltip({ foo: 'bar' }); // 调用hide方法 $(‘p').tooltip(‘hide'); //调用Update方法 $(‘p').tooltip(‘update', ‘This is the new tooltip content!');
这种类型的插件架构允许您封装所有的方法在父包中,通过传递该方法的字符串名称和额外的此方法需要的参数来调用它们。 这种方法的封装和架构类型是jQuery插件社区的标准,它被无数的插件在使用,包括jQueryUI中的插件和widgets。
八、事件
一个鲜为人知bind方法的功能即允许绑定事件命名空间。 如果你的插件绑定一个事件,一个很好的做法是赋予此事件命名空间。 通过这种方式,当你在解除绑定的时候不会干扰其他可能已经绑定的同一类型事件。 你可以通过追加命名空间到你需要绑定的的事件通过 ‘.'。
. 代码如下:
(function ($) { var methods = { init: function (options) { return this.each(function () { $(window).bind('resize.tooltip', methods.reposition); }); }, destroy: function () { return this.each(function () { $(window).unbind('.tooltip'); }) }, reposition: function () { //... }, show: function () { //... }, hide: function () { //... }, update: function (content) { //... } }; $.fn.tooltip = function (method) { if (methods[method]) { return methods[method].apply(this, Array.prototype.slice.call(arguments, 1)); } else if (typeof method === 'object' || !method) { return methods.init.apply(this, arguments); } else { $.error('Method ' + method + ' does not exist on jQuery.tooltip'); } }; })(jQuery); $('#fun').tooltip(); //一段时间之后… … $(‘#fun').tooltip(‘destroy');
在这个例子中,当tooltip通过init方法初始化时,它将reposition方法绑定到resize事件并给reposition非那方法赋予命名空间通过追加.tooltip。 稍后, 当开发人员需要销毁tooltip的时候,我们可以同时解除其中reposition方法和resize事件的绑定,通过传递reposition的命名空间给插件。 这使我们能够安全地解除事件的绑定并不会影响到此插件之外的绑定。
九、数据
通常在插件开发的时候,你可能需要记录或者检查你的插件是否已经被初始化给了一个元素。 使用jQuery的data方法是一个很好的基于元素的记录变量的途径。尽管如此,相对于记录大量的不同名字的分离的data, 使用一个单独的对象保存所有变量,并通过一个单独的命名空间读取这个对象不失为一个更好的方法。
. 代码如下:
(function ($) { var methods = { init: function (options) { return this.each(function () { var $this = $(this), data = $this.data('tooltip'), tooltip = $('', { text: $this.attr('title') }); // If the plugin hasn't been initialized yet if (!data) { /* Do more setup stuff here */ $(this).data('tooltip', { target: $this, tooltip: tooltip }); } }); }, destroy: function () { return this.each(function () { var $this = $(this), data = $this.data('tooltip'); // Namespacing FTW $(window).unbind('.tooltip'); data.tooltip.remove(); $this.removeData('tooltip'); }) }, reposition: function () { // ... }, show: function () { // ... }, hide: function () { // ... }, update: function (content) { // ... } }; $.fn.tooltip = function (method) { if (methods[method]) { return methods[method].apply(this, Array.prototype.slice.call(arguments, 1)); } else if (typeof method === 'object' || !method) { return methods.init.apply(this, arguments); } else { $.error('Method ' + method + ' does not exist on jQuery.tooltip'); } }; })(jQuery);
将数据通过命名空间封装在一个对象中,可以更容易的从一个集中的位置读取所有插件的属性。
十、总结和最佳做法
编写jQuery插件允许你做出库,将最有用的功能集成到可重用的代码,可以节省开发者的时间,使开发更高效。 开发jQuery插件时,要牢记:
1.始终包裹在一个封闭的插件:
. 代码如下:
(function($) { /* plugin goes here */ })(jQuery);
2.不要冗余包裹this关键字在插件的功能范围内
3.除非插件返回特定值,否则总是返回this关键字来维持chainability 。
4.传递一个可拓展的默认对象参数而不是大量的参数给插件。
5.不要在一个插件中多次命名不同方法。
3.始终命名空间的方法,事件和数据。
最后加一个自己写的放大镜的插件`
(function($){$.fn.Fdj=function(){ $('#smallImg').on('mouseover', function() { $('#slider').show(); }) $('#smallImg').on('mouseout', function() { $('#slider').hide(); }) $('#smallImg').on('mousemove', function(e) { var x = e.clientX - $('#slider').width() / 2; var y = e.clientY - $('#slider').height() / 2; if(x <= 0) { x = 0 } if(x > $('#smallImg').width() - $('#slider').width()) { x = $('#smallImg').width() - $('#slider').width(); } if(y <= 0) { y = 0 } if(y > $('#smallImg').height() - $('#slider').height()) { y = $('#smallImg').height() - $('#slider').height(); } $('#slider').css({ 'left': x, 'top': y }) var X=x/$('#smallImg').width()*800 var Y=y/$('#smallImg').height()*800 $('#img').css({ left:-X, top:-Y }) }) } })(jQuery)
相信看了本文案例你已经掌握了方法,更多精彩请关注php中文网其它相关文章!
推荐阅读:
以上是jQuery外掛程式封裝步驟詳解的詳細內容。更多資訊請關注PHP中文網其他相關文章!