注释名
语法
含义
示例
@param
@param 参数名 {参数类型} 描述信息
描述参数的信息
@param name {String} 传入名称
@return
@return {返回类型} 描述信息
描述返回值的信息
@return {Boolean} true:可执行;false:不可执行
@author
@author 作者信息 [附属信息：如邮箱、日期]
描述此函数作者的信息
@author 张三 2015/07/21
@version
@version XX.XX.XX
描述此函数的版本号
@version 1.0.3
@example
@example 示例代码
演示函数的使用
@example setTitle('测试')
示例：
/** * 合并Grid的行 * @param grid {Ext.Grid.Panel} 需要合并的Grid * @param cols {Array} 需要合并列的Index(序号)数组；从0开始计数，序号也包含。 * @param isAllSome {Boolean} ：是否2个tr的cols必须完成一样才能进行合并。true：完成一样；false(默认)：不完全一样 * @return void * @author polk6 2015/07/21 * @example * _________________ _________________ * | 年龄 | 姓名 | | 年龄 | 姓名 | * ----------------- mergeCells(grid,[0]) ----------------- * | 18 | 张三 | => | | 张三 | * ----------------- - 18 --------- * | 18 | 王五 | | | 王五 | * ----------------- ----------------- */ function mergeCells(grid, cols, isAllSome) { // Do Something }
三、框架开发
3.1 全局变量冲突
在团队开发或者引入第三方JS文件时，有时会造成全局对象的名称冲突，比如a.js有个全局函数sendMsg() ，b.js也又有个全局函数sendMsg() ，引入a.js和b.js文件时，会造成sendMsg()函数冲突。
示例：
3.2 单全局变量
所创建的全局对象名称是独一无二的，并将所有的功能代码添加到这个全局对象上。调用自己所写的代码时，以这个全局对象为入口点。
如：
* JQuery的全局对象：$和JQuery
* ExtJS的全局对象： Ext
示例：
3.3 命名空间
在项目规模日益壮大时，可采用命名空间方式对JS代码进行规范：即将代码按照功能进行分组，以组的形式附加到单全局对象上。
以Ext的chart模块为例：
更多关于JavaScript相关内容感兴趣的读者可查看本站专题：《JavaScript切换特效与技巧总结》、《JavaScript查找算法技巧总结》、《JavaScript动画特效与技巧汇总》、《JavaScript错误与调试技巧总结》、《JavaScript数据结构与算法技巧总结》、《JavaScript遍历算法与技巧总结》及《JavaScript数学运算用法总结》