Fork me on GitHub
跟我一起学JQuery插件开发

以前一直比较好奇,jquery插件是怎么开发的,怎么写属于自己的插件?

昨天在逛codeproject网站的时候,突然看到一篇文章:How to write plugin in Jquery.

如果对E文好的同学 ,可以看上面的连接。

现在我把上面网站的及结合自己的想法写这篇文章。希望能得到大牛们的支持和谅解。。。大鸟飞过。。。欢迎拍装。

资料来源:

【1】How to write plugin in Jquery.

【2】锋利的JQuery  书

【3】RascallySnakeJQuery.extend()详解

一.介绍

插件编写的目的是给已经有的一系列方法或函数做一个封装,以便在其他地方重复使用,方便后期维护。

JQuery除了提供一个简单、有效的方式进行管理元素以及脚本,它还还提供了例外一种机制:即给核心模块增加自己的方法和额外的功能。通过这种机制,Jquery允许我们自己创建属于我们自己的插件,提高我们在开发过程中的效率。

1.1JQuery的插件分为3中类型:

(1)封装对象方法的插件

这种类型的插件是我们今天需要讲的插件。

(2)封装全局函数的插件

指可以把独立的函数添加到JQuery命名空间之下。

(3)选择器插件

1.2编写JQuery插件需要注意的地方:

(1)插件的推荐命名方法为:jquery.[插件名].js

(2)所有的对象方法都应当附加到JQuery.fn对象上面,而所有的全局函数都应当附加到JQuery对象本身上。

(3)在插件内部,this指向的是当前通过选择器获取的JQuery对象,而不像一般方法那样,内部的this指向的是DOM元素。

(4)可以通过this.each 来遍历所有的元素

(5)所有方法或函数插件,都应当以分号结尾,否则压缩的时候可能会出现问题。为了更加保险写,可以在插件头部添加一个分号(;),以免他们的不规范代码给插件带来 影响。

(6)插件应该返回一个JQuery对象,以便保证插件的可链式操作。

(7)避免在插件内部使用$作为JQuery对象的别名,而应当使用完整的JQuery来表示。这样可以避免冲突。

1.3JQuery插件的机制

JQuery提供了2个用于扩展JQuery功能的方法。即:

①jQuery.fn.extend()

②jQuery.extend()

第一个就是我们前面说插件类型的第一个中情况,第二个就是指后面的2种情况。

jQuery.extend()在插件中友一个很重要的功能是扩展已经有的object的对象。

比如:

 var newSrc=$.extend(dest,src1,src2,src3...)

它的含义是将src1,src2,src3...合并到dest中,返回值为合并后的dest,由此可以看出该方法合并。

示例:

var result=$.extend({},{name:"Tom",age:21},{name:"Jerry",sex:"Boy"})

得到的结果是:

result={name:"Jerry",age:21,sex:"Boy"}

更加详细的 可以查看:jQuery.extend 函数详解 里面对这个方法有很好的讲解。

官网:JQuery.extend()与JQuery.fn.extend()

二.第一个Jquery插件

如果需要写一个JQuery插件,你需要在$.fn对象后面增加一个属性名,这个属性名 其实 就是你的插件名。它的一般框架如下:

(function( $ ) {
$.fn.myPlugin = function() {

// 这里开始写功能需求

};
})( jQuery );

现在我们需要写的插件的功能很简单,就是把一个对象给慢慢的隐藏起来。就是使用fadeOut()这个方法。

OK,我们打开 VS 2012.新建一个jscript文件,并且命名为:MyPlugin.js,并在里面添加如下代码:

(function ($) {
$.fn.myPlugin = function () {
this.fadeOut('normal');
};
})(jQuery);

怎么用呢?很简单。

新建一个html页面,把jquery文件以及刚刚我们MyPlugin.js文件导入到本次页面中。如下:

<script src="Scripts/jquery-1.4.1.js" type="text/javascript"></script>
<script src="MyPlugin.js" type="text/javascript"></script>

js代码:

<script type="text/javascript">
$(document).ready(function () {
$("#btn1").click(function () {
$("#div1").myPlugin();
});
});
</script>

HTML代码:

 <div id="div1" >
My God</div>
<input id="btn1" type="button" value="button" onclick="MyClick()" />

好的,你现在点击网页上面的按钮的时候,div就会缓缓的隐藏。。。因为我们设定的是normal嘛,里面也可以设定一些值之类的。

很兴奋的是,既然这个有智能提示,如下图:


很酷吧!

三.插件运用在多个元素控件中。

3.1 运用在多个元素控件中

在上面编写JQuery插件需要注意的地方的第四点,写道 如果要遍历 则可以用this.each方法。$("ID").each 可以遍历jquery对象、数组以及集合。

OK。知道了这样子,那么我们的新的代码如下:

(function ($) {
$.fn.hoverElement = function () {
this.each(function () {
$(this).hover(
function () {
$(this).addClass("Add");
},
function () {
$(this).removeClass("Remove");
}
);
})
}
})(jQuery);

上面主要用到.each()方法进行遍历。代码很简单,就是把当前的对象的背景色css样式在“Add”和“Remove”直接切换。

HTML的代码是:

<div class="hoverText">
        First Button..
    </div>
    <div class="hoverText">
        Second Button..
    </div>
    <div class="hoverText">
        Third Button..
    </div>

 JS 代码:

<script type="text/javascript">
$(document).ready(function () {
$(".hoverText").hoverElement();
});
</script>

很简单,不解释。

3.2 链式操作
链式操作?都听过吧。。。比如下面这一句话:

$("#div1").css("color", "red").addClass("Add").animate({"width":"100px"},1000);

就是能在当前的元素后面通过“.” 来实施更多的操作。这个动作特别的潇洒。

那我们要怎么才能实现这种效果呢?很简单,我能只需要把对象回去就可以了。请注意上面的第六点:插件应该返回一个JQuery对象,以便保证插件的可链式操作

我们依旧看刚刚的例子:

(function ($) {
$.fn.hoverElement = function () {
return this.each(function () {
$(this).hover(
function () {
$(this).addClass("Add");
},
function () {
$(this).removeClass("Remove");
}
);
})
}
})(jQuery);

代码都一样,唯一区别的是:this.each(function () { 这个前面加了一个 return。这样就实现了我们的链式操作。

然后 你这样:

$(document).ready(function () {
$(".hoverText").hoverElement().css("color","yellow");
});

能看到 文字已经变成了yellow色的了。


四 自定义自己的插件

对于一个商业插件来说,自定义插件的样式是必不可少的。我们可以通过我们自己输入不同的样式,来改变开发者的默认样式。比如说最常见的 width、height、url、color等等。要是没有这些自定义的东西,那开发者开发的插件的利用价值就大大的减小了。

OK,下面的这个实例的意思是 当我们hover一个对象的时候,它能改变它的text、background、foreground三个属性,也就是文本、背景色、前景色。用户可以设定他自己想设定的值,而不是固定死的。当然,如果用户没有设置,我们会给他一个默认值。

定义这类插件的开发框架是:

$.fn.YouPlugin = function (options) {...} 

为了防止一些偷懒的人,我们需要设置一些默认值,当它没有设置的时候,我们就用这些默认值。

var defaultVal = {
Text: 'Your mouse is over',
ForeColor: 'red',
BackColor: 'gray'
};

那默认值和用户传进来的值是怎么联合在一起的呢?这个就需要我们在开篇的时候讲到的$.extend()知识了。

var obj = $.extend(defaultVal, options);

这样子的话,就把用户自定义的值覆盖了默认用户的值。如果用户没定义值,就用系统自定义的。

代码如下:

(function ($) {
$.fn.textHover = function (options) {//options 经常用这个表示有许多个参数。

var defaultVal = {

Text: 'Your mouse is over',
ForeColor: 'red',
BackColor: 'gray'
};
      //默认值
var obj = $.extend(defaultVal, options);

return this.each(function () {

var selObject = $(this);//获取当前对象

var oldText = selObject.text();//获取当前对象的text值
var oldBgColor = selObject.css("background-color");//获取当前对象的背景色
var oldColor = selObject.css("color");//获取当前对象的字体的颜色

selObject.hover(function () {//定义一个hover方法。

selObject.text(obj.Text);//进行赋值
selObject.css("background-color", obj.BackColor);//进行赋值
selObject.css("color", obj.ForeColor);//进行赋值
},
function () {
selObject.text(oldText);
selObject.css("background-color", oldBgColor);
selObject.css("color", oldColor);
}
);
});
}
})(jQuery);

代码也很简单,上面都有些了解释,此刻不在罗嗦。

怎么用呢?很简单。

HTML code:

<div id="div1" class="textBar">
Mouse over here.....
</div>
<div id="div2" class="textBar">
Mouse over here.....
</div>

JS Code:

$(document).ready(function () {

$('#div1').textHover({
Text: 'I am going to over..',
ForeColor: 'yellow',
BackColor: 'Red'
});
$('#div2').textHover({ Text: 'I am second div...' });
});

就能看到效果了。

希望对你们有帮助。

OK,到现在为止,应该一个插件开发的基本要素就这些了。本来后面还有一个比较复杂的代码,一起发的,等下一节吧!

猛击源码下载
猛击源码下载

老骥伏枥,志在千里


本博内容可以随意粘贴、复制以及拷贝,不过如果可以,请标注一下文章出处,尊重一下作者的劳动成果。

随笔分类 -JQuery

跟我一起学JQuery插件开发

2012-04-06 16:29 by 随风浪迹天涯, 943 visits, 网摘收藏编辑
摘要:以前一直比较好奇,jquery插件是怎么开发的,怎么写属于自己的插件?昨天在逛codeproject网站的时候,突然看到一篇文章:How to write plugin in Jquery.如果对E文好的同学 ,可以看上面的连接。现在我把上面网站的及结合自己的想法写这篇文章。希望能得到大牛们的支持和谅解。。。大鸟飞过。。。欢迎拍装。资料来源:【1】How to write plugin in Jquery.【2】锋利的JQuery 书【3】RascallySnake的JQuery.extend()详解一.介绍插件编写的目的是给已经有的一系列方法或函数做一个封装,以便在其他地方重复使用,方便后期 阅读全文

平安夜分享2款下拉菜单(CSS版本和JQuery版本)

2011-12-24 17:28 by 随风浪迹天涯, 446 visits, 网摘收藏编辑
摘要:昨天有一个同事,叫我帮忙,说他需要一个下拉菜单,叫我帮他整个出来。我说没问题啊,中午花了点时间,然后就给它弄了一个CSS样式的(这个这个是我 以前弄好的,一直收藏着,就拿出来改了改 给他了)。可是,昨天下班的时候,他说他还想看一看jquery实现的下拉菜单,呵呵,我说你老兄可真够贪心的,不过 既然人家都说了,我昨天晚上就整了一个jquery的下拉菜单。其实,2个版本都很简单。希望对各位看官有帮助。HTML coed:2个都运用下面的这个HTML代码作为演示实例:<div id="div" class="menu"> <ul> &l 阅读全文

JQueyr 动画效果集锦

2011-11-21 17:57 by 随风浪迹天涯, 106 visits, 网摘收藏编辑
摘要:把js的一些动画效果进行了整理,期中有很多都是参考了网上的高人,甚至有些直接拿过来用了。再次谢过。当做自己的温习。1.Show()和Hide()方法 Show()以及Hide()在jquery动画里应该是最最基本的动画了吧。如果调用hide()动画的话,会把css样式里的display改为none。语法:$(selector).show(speed,callback)参数描述speed可选。规定元素从隐藏到完全可见的速度。默认为 "0"。可能的值: 毫秒 (比如 1500) "slow" "normal" "fast&quo 阅读全文

解析JQuery 的Bind()事件

2011-11-04 17:55 by 随风浪迹天涯, 1380 visits, 网摘收藏编辑
摘要:想了很久,该不该发到圆子的首页,因为从来没有发到首页,这里高手众多生怕被人笑话。后来,旁边的一个同事说,还行,就发了。如果有什么太浅显的地方,希望大家能多多包涵。随着现在JQuery这个javascript的越来越强大,在我们平常的前端UI开发,如果不使用JQuery,说明你已经很out了。今天我们来学习一下 JQuery的bind事件。虽然,这个话题被很多写了很多,但我还是想自己在这里班门弄斧一下,希望各位看官不要喷。如果有什么意见,可以直接进行交流,共同进步。JQuery 官网的Bind事件的API吧:地址连接。如果各位有兴趣看洋文的,可是去看看。刚开始我们先看一下它的定义:.bind( 阅读全文

介绍 JQuery 强大的jWiard 向导控件

2011-10-28 11:47 by 随风浪迹天涯, 491 visits, 网摘收藏编辑
摘要:我就不贴我现在做项目的代码,我直接把作者的示例搬过来,因为改动不大,只要做点修改,就能很好的满足我们自己的需求。原文地址 猛点这里下载作者官网 不过是英文的,英语好的话 可以看原文,生怕我表达错误。不知道童鞋们在平时的开发用到用向导式开发这种方式没有?有人问 什么是向导式开发呢?其实,很简单,就是让用户完成一个步骤,然后点击下一步,完成一个步骤就点击下一步,这样 按照我师父的来说,可以很好的提升用户体验。OK,废话不说了,先来一个最简单的例子:例子1:1.1当然咯,既然是JQuery 就少不了需要引用JQuery库吧。在上面就能下到相关的类库。JQuery Class and Style 1 阅读全文
posted on 2012-04-06 23:43  HackerVirus  阅读(594)  评论(1编辑  收藏  举报