javascript编码规范

1.变量名:

  变量名包含全局变量,局部变量,类变量,函数参数变量;

2.构造函数,类命名:

  首字母大写,驼峰式命名;

3.普通变量命名:

  首字母小写,驼峰式命名,匈牙利命名;

  如:isblue 表示整形的数值;

  匈牙利命名法语法:变量名=类型+对象描述

  虽然JavaScript变量表面上没有类型,但是JavaScript内部还是会为变量赋予相应的类型

 4.函数命名:

     普通函数:首字母小写,驼峰式命名,统一使用动词或者动词+名词形式  

  例如:fnGetVersion(),fnSubmitForm(),fnInit();

   内部函数:使用_fn+动词+名词形式,内部函数必需在函数最后定义。

如:function fnGetNumber(nTotal) {
      if (nTotal < 100) {
          nTotal = 100;
      }
      return _fnAdd(nTotal);

      function _fnAdd(nNumber) {
          nNumber++;
          return nNumber;
      }
  }
  alert(fGetNumber(10));  //alert 101

函数方法常用的动词
get 获取/set 设置,
add 增加/remove 删除
create 创建/destory 移除
start 启动/stop 停止
open 打开/close 关闭,
read 读取/write 写入
load 载入/save 保存,
create 创建/destroy 销毁
begin 开始/end 结束,
backup 备份/restore 恢复
import 导入/export 导出,
split 分割/merge 合并
inject 注入/extract 提取,
attach 附着/detach 脱离
bind 绑定/separate 分离,
view 查看/browse 浏览
edit 编辑/modify 修改,
select 选取/mark 标记
copy 复制/paste 粘贴,
undo 撤销/redo 重做
insert 插入/delete 移除,
add 加入/append 添加
clean 清理/clear 清除,
index 索引/sort 排序
find 查找/search 搜索,
increase 增加/decrease 减少
play 播放/pause 暂停,
launch 启动/run 运行
compile 编译/execute 执行,
debug 调试/trace 跟踪
observe 观察/listen 监听,
build 构建/publish 发布
input 输入/output 输出,
encode 编码/decode 解码
encrypt 加密/decrypt 解密,
compress 压缩/decompress 解压缩
pack 打包/unpack 解包,
parse 解析/emit 生成
connect 连接/disconnect 断开,
send 发送/receive 接收
download 下载/upload 上传,
refresh 刷新/synchronize 同步
update 更新/revert 复原,
lock 锁定/unlock 解锁
check out 签出/check in 签入,
submit 提交/commit 交付
push 推/pull 拉,
expand 展开/collapse 折叠
begin 起始/end 结束,
start 开始/finish 完成
enter 进入/exit 退出,
abort 放弃/quit 离开
obsolete 废弃/depreciate 废旧,
collect 收集/aggregate 聚集



5.注释编写;

   公共组件维护者和各栏目WD都需要在文件头部加上注释说明:

/**
*文件用途说明
*作者姓名、联系方式(旺旺)
*制作日期
**/
大的模块注释方法:
//================
// 代码用途
//================


小的注释;
//代码说明

注释单独一行,不要在代码后的同一行内加注释。例如:
//姓名
var name = “abc”;   V
var name =”abc”; //姓名 X


6.空格使用:
  • 在分开for循环的各个部分的分号之后:例如,for (var i = 0; i < 10; i +=1){…}
  • 在for循环中初始化多个变量(i和最大值等):for (var i = 0, max = 10; i < max; i += 1){…}
  • 在限定数组项的逗号后面:var a = [1, 2, 3];
  • 对象属性的逗号之后和将属性名和属性值分开的冒号之后:var o = {a: 1, b: 2};
  • 分隔开函数中各个参数的逗号之后:myFunc(a, b, c)
  • 在函数声明的大括号之前:function myFunc() {}
  • 在匿名函数表达式之后:var myFunc = function () {};
在需要以{}闭合的代码段前增加换行,如:for if
// 有了换行,逻辑清楚多了
 if (wl && wl.length) {

     for (i = 0, l = wl.length; i < l; ++i) {
         p = wl[i];
         type = Y.Lang.type(r[p]);

         if (s.hasOwnProperty(p)) {
             // 处理merge逻辑
             if (merge && type == 'object') {
                 Y.mix(r[p], s[p]);
             } else if (ov || !(p in r)) {
                 r[p] = s[p];
             }
         }
     }
 }
 
原文地址:https://www.cnblogs.com/kgwei520blog/p/12395324.html