如何编写jquery插件
前面的话
编写插件的目的是给已经有的一系列方法或函数做一个封装,以便在其他地方重复使用,提高开发效率和方便后期维护。本文将详细介绍如何编写jquery插件
类型
jquery的插件主要分为3种类型
1、封装对象方法
这种插件是将对象方法封装起来,用于对通过选择器获取的jquery对象进行操作,是最常见的一种插件。此类插件可以发挥出jquery选择器的强大优势,有相当一部分的jquery的方法,都是在jquery脚本库内部通过这种形式“插”在内核上的,例如:parent()方法、appendto()方法等。这些方法在现在来看都是jquery本身自带的方法了。平时,我们是可以直接拿来就用的,只需引入jquery库就行
2、封装全局函数
可以将独立的函数加到jquery命名空间下,如常用的jquery.ajax()、去首尾空格的jquery.trim()方法等,都是jquery内部作为全局函数的插件附加到内核上去的
3、选择器插件
虽然jquery的选择器十分强大,但是在少数情况下,还是会需要用到选择器插件来扩充一些自己喜欢的选择器
要点
1、jquery插件的文件名推荐命名为jquery.[插件名].js,以免和其他js库插件混淆
2、所有的对象方法都应当附加到jquery.fn对象上,而所有的全局函数都应当附加到jquery对象本身上
3、在插件内部的this指向的是当前通过选择器获取的jquery对象,而不像一般方法那样,如click,内部的this指向的是dom元素
4、可以通过this.each来遍历所有的元素
5、所有的方法或函数插件,都应当以分号结尾。否则压缩的时候可能出现问题。为了稳妥些,甚至可以在插件头部先加上一个分号,以免他人不规范的代码影响自身的插件代码
6、插件应该返回一个jquery对象,以保证插件的可链式操作
7、避免在插件内部使用$作为jquery对象的别名,而应使用完整的jquery来表示,避免冲突。当然,也可以利用闭包来回避这种问题,使插件内部继续使用$作为jquery的别名
闭包
利用闭包的特性,即可以避免内部临时变量影响全局空间,又可以在插件内容继续使用$作为jquery的别名。常见的jquery插件都是以下这种形式的:
(function(){ /*这里放置代码*/ })();
首先定义一个匿名函数function(){/*这里放置代码*/},然后用括号括起来,变成(function(){/*这里放置代码*/})这种形式,最后通过()这个运算符来执行。可以传递参数进行,以供内部函数使用
//为了更好的兼容性,开始前有个分号 ;(function($){ //此处将$作为匿名函数的形参 /*这里放置代码,可以使用$作为jquery的缩写别名*/ })(jquery); //这里就将jquery作为实参传递给匿名函数了
上面的代码是一种常见的jquery插件的结构
插件机制
jquery提供了两个用于拓展jquery功能的方法,即jquery.fn.extend()方法和jquery.extend()方法。jquery.fn.extend()方法用于拓展封装对象方法的插件,jquery.extend()方法用于拓展封装全局函数的插件和选择器插件。这两个方法都接受一个参数,类型为object。object对象的"名/值对"分别代表"函数或方法名/函数主体"
【jquery.fn.extend()】
jquery.fn.extend()方法用于将一个对象的内容合并到jquery的原型,以提供新的jquery实例方法
<label><input type="checkbox" name="foo"> foo</label> <label><input type="checkbox" name="bar"> bar</label> <button id="btn1">全选</button> <button id="btn2">全不选</button> <script> jquery.fn.extend({ check: function() { return this.each(function() { this.checked = true; }); }, uncheck: function() { return this.each(function() { this.checked = false; }); } }); $('#btn1').click(function(){ $( "input[type='checkbox']" ).check(); }); $('#btn2').click(function(){ $( "input[type='checkbox']" ).uncheck(); }); </script>
【jquery.extend()】
jquery.extend()方法用一个或多个其他对象来扩展一个对象,然后返回被扩展的对象
jquery.extend( target [, object1 ] [, objectn ] )
例如,合并settings对象和options对象,修改并返回settings对象
var settings = {validate:false,limit:5,name:"foo"}; var options = {validate:true,name:"bar"}; var newoptions = jquery.extend(settings,options); console.log(newoptions);//object {validate: true, limit: 5, name: "bar"} jquery.extend()方法经常被用于设置插件方法的一系列默认参数 function foo(options){ options=jquery.extend({ name:"bar", length:5, datatype:"xml" },options); }
如果用户调用foo()方法的时候,在传递的参数options对象设置了相应的值,那么就使用设置的值,否则使用默认值
通过使用jquery.extend()方法,可以很方便地用传入的参数来覆盖默认值。此时,对方法的调用依旧保持一致,只不过要传入的是一个映射而不是一个参数列表。这种机制比传统的每个参数都去检测的方式不仅灵活而且更加简洁。此外使用命名参数意味着再添加新选项也不会影响过去编写的代码,从而使开发者使用起来更加直观明了
编写插件
1、封装jquery对象方法的插件
编写设置和获取颜色的插件color(),该插件用于实现以下两个功能:
(1)设置匹配元素的颜色
(2)获取匹配的元素(元素集合中的第一个)的颜色
由于是对jquery对象的方法拓展,因此采用拓展第一类插件的方法jquery.fn.extend()来编写,这里给这个方法提供了一个参数value,如果调用方法的时候传递了value这个参数,那么就是用这个值来设置字体颜色,否则就是获取匹配元素的字体颜色的值
;(function(){ jquery.fn.extend({ "color":function(value){ if(value == undefined){ return this.css("color"); }else{ return this.css("color",value); } } }); })(jquery);
实际上,css()方法内容已经有判断value是否为undefined的机制,所以才可以根据传递参数的不同而返回不同的值。因此,代码可以删减如下
;(function(){ jquery.fn.extend({ "color":function(value){ return this.css("color",value); } }); })(jquery);
<span id="test">测试文字</span> <input type="color" id="color"> <script> ;(function($){ $.fn.extend({ "color":function(value){ return this.css("color",value); } }); })(jquery); $('#color').on('change',function(){ $('#test').color($(this).val()); }) </script>
另外,如果要定义一组插件,可以使用如下所示写法:
;(function(){ jquery.fn.extend({ "color":function(value){ //插件代码 }, "border":function(value){ //插件代码 }, "background":function(value){ //插件代码 } }); })(jquery);
2、封装全局函数的插件
这类插件是在jquery命名空间内部添加一个函数
例如新增两个函数,用于去除左侧和右侧空格。虽然jquery已经提供了jquery.trim()方法来去除两端空格,但在某些情况下,会只希望去除某一侧的空格
去除左侧、右侧的空格的函数分别写成如下jquery代码。(text||"")部分是用于防止传递进来的text这个字符串变量处于未定义的特殊状态,如果text是undeined,则返回字符串"",否则返回字符串text。这个处理是为了保证接下来的字符串替换方法replace()方法不会出错
;(function($){ $.extend({ ltrim:function( text ){ return (text || "").replace(/^\s+/g,""); }, rtrim:function( text ){ return (text || "").replace(/\s+$/g,""); } }); })(jquery); var $str = " test "; console.log($.trim($str));//'test' console.log($.ltrim($str));//'test ' console.log($.rtrim($str));//' test'
3、自定义选择器
jquery以其强大的选择器著称,那么jquery的选择器的工作原理是什么呢?
jquery的选择解析器首先会使用一组正则表达式来解析选择器,然后针对解析出的每一个选择符执行一个函数,称为选择函数。最后根据这个选择函数的返回值为true还是false来决定是否保留这个元素,这样就可以找到匹配的元素节点
如$("div:gl(1)"),该选择器首先会获取所有的<div>元素,然后隐式地遍历这些<div>元素,并逐个将这些<div>元素作为参数,连同括号里的“1”等一些参数一起传递给gt对应的选择器函数进行判断。如果返回true则保留,否则不保留,这样得到的结果就是一个符合要求的<div>元素的集合
选择器的函数一共接受3个参数,形式如下:
function (a,i,m){ //... }
第一个参数为a,指的是当前遍历到的dom元素
第二个参数为i,指的是当前遍历到的dom元素的索引值,从0开始
第三个参数是m,它是由jquery正则解析引擎进一步解析后的产物,是一个数组:其中最重要的一个是m[3],在$("div:gl(1)")中即为括号里的数字“1”。
在jquery中已经有lt、gt和eq选择器,因此这里写一个介于两者之间(between)的选择器
思路:在上面的三个参数中,m[3]为"a,b"的形式,因此把m[3]用","分隔,然后跟索引值i进行对比,如果i在m[3]表示的范围之间就返回true,否则为false
;(function($){ $.extend($.expr[":"],{ between:function(a,i,m){ var temp=m[3].split(","); return +temp[0]<i&&i<+temp[1]; } }); })(jquery);
[注意]经测试,函数中第二个参数i的值始终为0,无法获取索引值,这时就需要自造索引,代码如下
;(function($){ var $index = -1; $.extend($.expr[":"],{ between:function(a,i,m){ var temp=m[3].split(","); $index++; return +temp[0]<$index&&$index<+temp[1]; } }); })(jquery);
<div> <i>0</i> <i>1</i> <i>2</i> <i>3</i> <i>4</i> <i>5</i> </div> <button id="btn">测试</button> <script> ;(function($){ var $index = -1; $.extend($.expr[":"],{ between:function(a,i,m){ var temp=m[3].split(","); $index++; return +temp[0]<$index&&$index<+temp[1]; } }); })(jquery); $('#btn').click(function(){ $('i:between(1,5)').css('background','lightblue'); }); </script>
以上就是本文的全部内容,希望本文的内容对大家的学习或者工作能带来一定的帮助,同时也希望多多支持!