前端开发规范文档（初稿）

总体原则

缩进

对于所有编程语言，我们要求缩进必须是软tab（用空格字符）。在你的文本编辑器里敲 Tab 应该等于 4个空格 。

可读性 vs 压缩

对于维护现有文件，我们认为可读性比节省文件大小更重要。大量空白和适当的ASCII艺术都是受鼓励的。任何开发者都不必故意去压缩HTML或CSS，也不必把Javascript代码最小化得面目全非。

我们会在服务器端或build过程中自动最小化并gzip压缩所有的静态客户端文件，例如CSS和JS

HTML,CSS,JS代码分离

html代码尽量保持整洁，采用最简单的代码层级完成复杂的布局要求，方便以后的维护和扩展

css代码本身都是全局的，所有应当采用css模块化思想，约束css的规则，尽量减少对全局的污染

JS代码分为功能代码和业务代码，功能代码尽量抽取成功能组件，方便团队内其他同事的使用

命名规范

文件及文件夹: 全部英文小写字母+数字或连接符"- , _ "，不可出现其他字符 如：jquery.1.x.x.js
文件：调用 /libs 文件需包含版本号，压缩文件需包含min关键词，其他插件则可不包含 如：/libs/modernizr-1.7.min.js
ID: 小駝峰式命名法 如：firstName topBoxList footerCopyright
Class: [减号连接符] 如：top-item main-box box-list-item-1
尽量使用语义明确的单词命名，避免 left bottom 等方位性的单独的词语命名样式

html规范

基本语法

在属性上，使用双引号，不要使用单引号。
不要在自动闭合标签结尾处使用斜线 - HTML5 规范 指出他们是可选的。
不要忽略可选的关闭标签（例如， 和 ）。
尽量用class来渲染样式，避免用id来写样式

Doctype

 在每个 HTML 页面开头使用这个简单地 doctype 来启用标准模式，使其每个浏览器中尽可能一致的展现。
  

 1      

查看更多关于前端开发规范文档（初稿）的详细内容...