文档章节

前端开发规范,简单的处理项目规范

misterChangRay
 misterChangRay
发布于 2017/04/23 17:49
字数 983
阅读 8
收藏 0

前往查看原文

文件规范:
  1. 文件命名全小写
  2. 多个单词之间使用中横线连接
  3. 文件编码统一使用UTF8
  4. 文件头必须要有注释,标明文件用途、作者、版本等信息
css命名规范:
  1. 类名全部为小写
  2. 类名多个单词之间使用中横线连接
js语法规范:
  1. 变量名/函数名统一使用小驼峰命名,可以为拼音或英文但不可混合使用,拼音应用全拼;
  2. 构造函数或类的声明应使用大驼峰命名;
  3. 请尽量语义化变量名/属性名/自定义标签名;
  4. 变量或函数应有其适当注释, 拒绝无注释代码, 并提高函数重用率;
  5. 无特别情况每行代码应尽量保持在100字符以内, 代码应有必要的缩进;
  6. 花括号和关键词应位于一行,不应另起一行,如:
   function user() {   //这里和function关键词位于一行
      ...
   };

   if(flag) {    //这里和if关键词同行
      ...
   };
  1. 请使用var 来声明变量,且在连续声明变量时注意加上空格, 如: var user, name; //在user, 和 name 之间保持一个空格;
  2. 私有变量以下划线打头如:var _classVarName;
  3. 常量应全为大写;
  4. 规范定义json对象, key 和 value 都加上双引号, 如: {“name”:”jackson”};
  5. 方法与方法之间应有一个空行;
  6. 提交代码前应先拉取代码,另外代码提交应写好1-50字的描述;
  7. 请注意语句结束或文件开头必须加上”;”号;
  8. 函数应该是统一的返回类型, 即:一个函数中不能有多个不同的数据类型返回;
  9. 函数命名应为动词+名词形式,部分常用命名参考常用固定命名;
  10. 字符串统一使用’单引号’, 且不要在非赋值的地方出现中文;
  11. 原则上可采用任意开发工具但不可如下使用:

使用IDE的视图模式”画”代码; 使用IDE的部分功能生成相关功能代码;

参考文档
  1. Web Styleguide
  2. Web前端开发规范文档
  3. 前端开发规范文档
附录 - 常用固定命名(XXXX可替换为名词)

固定命名 解释 示例/注释
initXXXX 初始化
queryXXXX 查询
getXXXX 获取
updateXXXX 更新
deleteXXXX 删除
saveXXXX 保存
importXXXX 引入
exportXXXX 导出
refreshXXXX 刷新 startXXXX 开始 encodeXXXX 编码 decodeXXXX 解码 restoreXXXX 恢复 resetXXXX 重置 resetForm/重置表单 sendXXXX 发送 calcXXXX 计算 常用动词参考 query 查询/update 更新/delete 删除 get 获取/set 设置/add 增加/remove 删除/create 创建/destory 移除 start 启动/stop 停止/open 打开/close 关闭/read 读取/write 写入 load 载入/save 保存/create 创建/destroy 销毁 begin 开始/end 结束/backup 备份/restore 恢复/detach 脱离 import 导入/export 导出/split 分割/merge 合并/inject 注入/extract 提取 attach 附着/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 运行/pack 打包/unpack 解包/parse 解析/emit 生成 compile 编译/execute 执行/debug 调试/trace 跟踪 observe 观察/listen 监听/build 构建/publish 发布/push 推/pull 拉 input 输入/output 输出/encode 编码/decode 解码 expand 展开/collapse 折叠/encrypt 加密/decrypt 解密 compress 压缩/decompress 解压缩 connect 连接/disconnect 断开/send 发送/receive 接收 download 下载/upload 上传/refresh 刷新/synchronize 同步 update 更新/revert 复原/lock 锁定/unlock 解锁 check out 签出/check in 签入/submit 提交/commit 交付 begin 起始/end 结束/start 开始/finish 完成/enter 进入/exit 退出 abort 放弃/quit 离开/obsolete 废弃/depreciate 废旧 collect 收集/aggregate 聚集

© 著作权归作者所有

共有 人打赏支持
misterChangRay
粉丝 1
博文 3
码字总数 7007
作品 1
成都
程序员
前端协作流程

Web系统   在介绍协作流程之前,首先简单地了解Web系统的结构   从宏观上来说,Web系统是部署在服务器上用于为web客户端提供服务的系统。不同的Web客户端根据不同的需求,发送请求到服务...

sshpp
2017/07/24
0
0
前端工程化——构建工具选型

注:文章源于2017年8月的一次内部分享,部分数据可能已经过时。 一、什么是前端工程化 前端工程化是依据业务特点,将前端开发的规范、流程、技术、工具、经验等形成规范并建立成一种标准的体...

Bellhe
01/08
0
0
亲身体验小程序wepy和mpvue框架的区别

前言 小编公司也随潮流,把现有h5项目,重做成小程序项目,前期是用wepy搭建的,开始感觉还不错,随着加入的功能越来越多,感觉性能也越来越成问题。下面我们来详细介绍。开发文档 原生开发小...

向建峰_Javan
08/15
0
0
小结(工作 + 生活)

今天早上出门去医院挂号,走到地铁忘记带钱,又折返回去拿钱包,挂好号了,走的时候却忘记把市民卡给双凤。一系列的不走心事情搞得我想死的心都有了。 想看些技术博客,看一页就没有耐心往下...

-波仔-
2016/08/02
17
0
java web全栈漫谈

一个项目从需求确认到上线,生命周期其实还是挺长的。作为一般公司的话,分工是比较具体的,比如从需求分析师,产品经理,美工,前端,后端再到运维,每个工种都有,但如果要全栈的话,还是要...

tomzhao
2016/10/16
190
2

没有更多内容

加载失败,请刷新页面

加载更多

Mac OS X下Maven的安装与配置

Mac OS X 安装Maven: 下载 Maven, 并解压到某个目录。例如/Users/robbie/apache-maven-3.3.3 打开Terminal,输入以下命令,设置Maven classpath $ vi ~/.bash_profile 添加下列两行代码,之后...

TonyStarkSir
今天
3
0
关于编程,你的练习是不是有效的?

最近由于工作及Solution项目的影响,我在重新学习DDD和领域建模的一些知识。然后,我突然就想到了这个问题,以及我是怎么做的? 对于我来说,提升技能的项目会有四种: 纯兴趣驱动的项目。即...

问题终结者
今天
4
0
打开eclipse出现an error has occurred see the log file

解决方法: 1,打开eclipse安装目录下的eclipse.ini文件; 2,打开的文本文件最后添加一行 --add-modules=ALL-SYSTEM 3,保存重新打开Eclipse。...

任梁荣
昨天
4
0
搞定Northwind示例数据库,无论哪个版本的SQLServer都受用

Northwind数据库 从这里可以找到突破口: http://social.msdn.microsoft.com/Forums/zh-CN/Vsexpressvb/thread/8490a1c6-9018-40c9-aafb-df9f79d29cde 下面是MSDN: http://msdn2.microsoft......

QQZZFT
昨天
1
0
mysql主从同步,安装配置操作

准备 两台mysql服务,我这里准备了如下: 主库:192.168.176.128 从库:192.168.176.131 如何在Linux上安装mysql服务,请看https://blog.csdn.net/qq_18860653/article/details/80250499 操作...

小致dad
昨天
5
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部