2、对象级别的插件开发
需如下两种形式
形式一:
- (function($){
- $.fn.extend({
- pluginName:function(opt,callback){
-
- }
- })
- })(jQuery);
形式二:
- (function($) {
- $.fn.pluginName = function() {
-
- };
- })(jQuery);
上面定义了jquery参数,形参是$,函数定义完之后,把jquery这个实参传进去,立即调用执行。这样的好处是,我们在写jquery插件时,也可以使用$这个别名,而不会与prototype冲突。
2.1 在jquery名称空间下申请一个名字
这是一个单一插件的脚本。如果你的脚本中包含多个插件,或许互逆的插件(例如:$.fn.doSomething()和$.fn.undoSomething()),那么你需要声明多个函数名字。但是,通常当我们编写一个插件时,力求仅使用一个名字来包含它的所有内容,
- $.fn.hilight = function() {
-
- };
- 我们的插件通过这样被调用:
- $(‘#myDiv‘).hilight();
如果需要分解其代码为多个函数(如:设计上的需要,更容易或更易读的实现,且符合面向对象)。把功能实现分解成多个函数而不增加多于命名空间。出于认识到和利用函数是javascript中最基本的类对象,可以这样做。就像其他对象一样,函数可以被指定为属性。因此我们已经声明“hilight”为jQuery的属性对象,任何其他的属性或者函数我们需要暴露出来的,都可以在"hilight" 函数中被声明属性。稍后继续。
2.2 接受options参数以控制插件的行为
添加功能 指定前景色和背景色的功能。选择一个options对象传递给插件函数
- $.fn.hilight = function(options) {
- var defaults = {
- foreground: ‘red‘,
- background: ‘yellow‘
- };
-
- var opts = $.extend(defaults, options);
-
- };
- 我们的插件可以这样被调用:
- $(‘#myDiv‘).hilight({
- foreground: ‘blue‘
- });
2.3 暴露插件的默认设置
改进以上代码使其暴露插件的默认设置。可更容易用较少的代码覆盖和修改插件。
- $.fn.hilight = function(options) {
-
-
-
- var opts = $.extend({}, $.fn.hilight.defaults, options);
-
- };
- $.fn.hilight.defaults = {
- foreground: ‘red‘,
- background: ‘yellow‘
- };
- 现在使用者可以包含像这样的一行在他们的脚本里:
- $.fn.hilight.defaults.foreground = ‘blue‘;
- 接下来我们可以像这样使用插件的方法,结果它设置蓝色的前景色:
- $(‘#myDiv‘).hilight();
如你所见,我们允许使用者写一行代码在插件的默认前景色。而且使用者仍然在需要的时候可以有选择的覆盖这些新的默认值:
// 覆盖插件缺省的背景颜色
$.fn.hilight.defaults.foreground = ‘blue‘;
// ...
// 使用一个新的缺省设置调用插件
$(‘.hilightDiv‘).hilight();
// ...
// 通过传递配置参数给插件方法来覆盖缺省设置
$(‘#green‘).hilight({
foreground: ‘green‘
});
2.4 适当的暴露一些函数例如,插件的实现里面可以定义一个名叫“format”的函数来格式化高亮文本。默认的format方法实现部分在hiligth函数下面。
- $.fn.hilight = function(options) {
-
- return this.each(function() {
- var $this = $(this);
-
- var markup = $this.html();
-
- markup = $.fn.hilight.format(markup);
- $this.html(markup);
- });
- };
- $.fn.hilight.format = function(txt) {
- return ‘<strong>‘ + txt + ‘</strong>‘;
- };
我们很容易的支持options对象中的其他的属性通过允许一个回调函数来覆盖默认的设置。这是另外一个出色的方法来修改你的插件。这里展示的技巧是进一步有效的暴露format函数进而让他能被重新定义。通过这技巧,是其他人能够传递他们自己设置来覆盖你的插件,换句话说,这样其他人也能够为你的插件写插件。 考虑到这个篇文章中我们建立的无用的插件,你也许想知道究竟什么时候这些会有用。一个真实的例子是Cycle插件.这个Cycle插件是一个滑动显示插件,他能支持许多内部变换作用到滚动,滑动,渐变消失等。但是实际上,没有办法定义也许会应用到滑动变化上每种类型的效果。那是这种扩展性有用的地方。 Cycle插件对使用者暴露"transitions"对象,使他们添加自己变换定义。插件中定义就像这样:
$.fn.cycle.transitions = {
// ...
};
这个技巧使其他人能定义和传递变换设置到Cycle插件。
2.5 保持私有函数的私有性
这种技巧暴露你插件一部分来被覆盖是非常强大的。但是你需要仔细思考你实现中暴露的部分。一但被暴露,你需要在头脑中保持任何对于参数或者语义的改动也许会破坏向后的兼容性。一个通理是,如果你不能肯定是否暴露特定的函数,那么你也许不需要那样做。那么我们怎么定义更多的函数而不搅乱命名空间也不暴露实现呢?这就是闭包的功能。为了演示,我们将会添加另外一个“debug”函数到我们的插件中。这个 debug函数将为输出被选中的元素格式到firebug控制台。为了创建一个闭包,我们将包装整个插件定义在一个函数中。
- (function($) {
-
- $.fn.hilight = function(options) {
- debug(this);
-
- };
-
- function debug($obj) {
- if (window.console && window.console.log)
- window.console.log(‘hilight selection count: ‘ + $obj.size());
- };
- })(jQuery);
我们的“debug”方法不能从外部闭包进入,因此对于我们的实现是私有的。
2.6支持Metadate插件
在你写插件的基础上,添加对Metadata插件支持能使他更强大。它让你使用不多的“markup”覆盖插件的选项,且支持它很简单
- $.fn.hilight = function(options) {
-
-
- var opts = $.extend({}, $.fn.hilight.defaults, options);
- return this.each(function() {
- var $this = $(this);
-
- var o = $.meta ? $.extend({}, opts, $this.data()) : opts;
-
这些变动行做了:测试meatadate插件是否被安装、如果是它能扩展options对象通过元数据这行为作为最后一个参数添加到jquery.extend,那么它会覆盖任何其它选项设置。现在我们能从“makeup”处驱动行为,如果选择了,调用时可这样写:jquery.foo()或$.foo();
- <!-- markup -->
- <div class="hilight { background: ‘red‘, foreground: ‘white‘ }">
- Have a nice day!
- </div>
- <div class="hilight { foreground: ‘orange‘ }">
- Have a nice day!
- </div>
- <div class="hilight { background: ‘green‘ }">
- Have a nice day!
- </div>
- 现在我们能高亮哪些div仅使用一行脚本:
- $(‘.hilight‘).hilight();
2.7 整合
- (function($) {
-
- $.fn.hilight = function(options) {
- debug(this);
-
- var opts = $.extend({}, $.fn.hilight.defaults, options);
-
- return this.each(function() {
- $this = $(this);
-
- var o = $.meta ? $.extend({}, opts, $this.data()) : opts;
-
- $this.css({
- backgroundColor: o.background,
- color: o.foreground
- });
- var markup = $this.html();
-
- markup = $.fn.hilight.format(markup);
- $this.html(markup);
- });
- };
-
- function debug($obj) {
- if (window.console && window.console.log)
- window.console.log(‘hilight selection count: ‘ + $obj.size());
- };
-
- $.fn.hilight.format = function(txt) {
- return ‘<strong>‘ + txt + ‘</strong>‘;
- };
-
- $.fn.hilight.defaults = {
- foreground: ‘red‘,
- background: ‘yellow‘
- };
- })(jQuery);
3.1 总结
Query为开发插件提拱了两个方法,分别是:
jQuery.fn.extend(object); 给jQuery对象添加方法。 jQuery.extend(object); 为扩展jQuery类本身.为类添加新的方法。
3.1 jQuery.fn.extend(object);
fn 是什么东西呢。查看jQuery代码,就不难发现。
jQuery.fn = jQuery.prototype = {
init: function( selector, context ) {//....
//......
};
原来 jQuery.fn = jQuery.prototype.对prototype肯定不会陌生啦。虽然 javascript 没有明确的类的概念,但是用类来理解它,会更方便。jQuery便是一个封装得非常好的类,比如我们用 语句 $("#btn1") 会生成一个 jQuery类的实例。
jQuery.fn.extend(object); 对jQuery.prototype进得扩展,就是为jQuery类添加“成员函数”。jQuery类的实例可以使用这个“成员函数”。
比如我们要开发一个插件,做一个特殊的编辑框,当它被点击时,便alert 当前编辑框里的内容。可以这么做:
$.fn.extend({
alertWhileClick:function(){
$(this).click(function(){
alert($(this).val());
});
}
});
$("#input1").alertWhileClick(); //页面上为:<input id="input1" type="text"/>
$("#input1") 为一个jQuery实例,当它调用成员方法 alertWhileClick后,便实现了扩展,每次被点击时它会先弹出目前编辑里的内容。
3.2 jQuery.extend(object);
为jQuery类添加添加类方法,可以理解为添加静态方法。如:
$.extend({
add:function(a,b){return a+b;}
});
便为 jQuery 添加一个为 add 的 “静态方法”,之后便可以在引入 jQuery 的地方,使用这个方法了,$.add(3,4); //return 7