jquery插件开发规范

一、请给你的代码加上注释

这个世界不存在百分百的完美的jquery插件，注释不止是给别人看、更重要的是给自己看。

你应该把注释当做你代码的一部分，养成随手加注释的习惯，尤其是编写javascript的时候。

1、在全部代码前加上文件说明注释

以下是插件加的注释：

/**
* $.yitip
* @extends jquery.1.4.2
* @fileOverview 创建文字提示框
* @author 姓名
* @email 123456@126.com
* @site wwww.123.com
* @version 0.1
* @date 2010-07-17
* Copyright (c) 2010-2010 姓名
* @example
* $("a").yitip();
*/
(function($){
.......
})(jQuery);

这是jsdoc的写法，什么是jsdoc？请点此。jsdoc简单点来说是一种javascript文档工具，使用方法可以点此。现在对jsdoc不理解没关系，你只要创建上述类似的说明文档即可。jsdoc的命令请点此查看。

2、函数务必加注释

比如以下代码是yijs.Yitip一个方法setContent：

yijs.Yitip.prototype = {
/**
*向提示框添加内容
* @param {Object | String} content 内容
*/
setContent : function(content){
...........
}
}

依旧遵循jsdoc规范，而不是匆匆加上“//”了事，关于jsdoc，有机会会详细讲解。

3、参数务必加注释

比如：

//默认参数
$.fn.yitip.defaults = {
/**目标容器*/
applyTo : null,
/**内容*/
content : "",
/**提示框位置*/
position : "topMiddle",
/**提示框位置偏移*/
},
/**提示框颜色*/
color : "yellow"
}

4、函数体内关键代码前加注释

二、javascript变量规范

在javascript世界中，没有真正意义的共有变量、私有变量、常量等概念，当你的javascript代码达到一定数量级时，过段时间你回头看自己的代码，都会把自己搞晕。

1、请在私有变量前加“_”

比如：

var_pos = this.pos;

2、常量请大写

比如：

this.DATA_COLOR = "color";

3、jquery对象变量前加“$”

比如：

this.$applyTo = $(".yitip");

4、object、array变量前加“o”、“a”

很多人喜欢给数组变量加个”s”，这也是可以的，按个人习惯，如果你觉得有必要还可以给函数前加个“fn”。

三、jquery插件开发的一些建议

1、请多使用data()方法

jquery中data()方法非常有用，尤其在jquery插件开发中，因为data()所创建的缓存，可以完整的保存各种数据类型的数据，这是其他缓存机制无法比拟的。

2、请使用bind来绑定事件

很多朋友喜欢以下的代码：

$(".yitip").click(function(){
........
})

但在jquery插件开发中更提倡使用bind：

$(".yitip").bind('click',function(){
.........
})

3、善用typeof

typeof用于判断数据类型，这个方法在参数判断中非常有用处

4、插件名加个独有前缀

jquery插件成千上万，插件撞车时很容易的事，比如提示框插件：

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

但tip的冲突率无疑很高，所以加个“yi”前缀，如果你有在网上看到以yi做前缀的插件，那估计就是写的，呵呵。

四、其他规范

1、设置版本号

有很多插件作者将版本号作为插件的一个属性，也是一个比较好的做法，比如：

$.fn.yitip.version = 0.1

你可以不设置为属性，但在你的文件头务必加上版本注释，比如：

/**
* $.yitip
* @version 0.1
*/

喜欢以0.1起始，然后把正式版的插件设置为1.0

2、将插件代码托管到网上

可以去sourceforge注册个账号，新建个开源项目，将代码托管上去，如果你不喜欢sourceforge，可以使用google的代码托管，可以看曾发表过的使用Google Code托管代码教程。有机会发篇教程讲述如何在sourceforge上托管代码。