前端开发规范

文件规范

1. html, css, js, images文件均归档至<系统开发规范>约定的目录中;

2. html文件命名: 英文命名, 后缀.htm. 同时将对应界面稿放于同目录中, 若界面稿命名为中文, 请重命名与html文件同名, 以方便后端添加功能时查找对应页面;

3. css文件命名: 英文命名, 后缀.css. 共用base.css, 首页index.css, 其他页面依实际模块需求命名.;

4. Js文件命名: 英文命名, 后缀.js. 共用common.js, 其他依实际模块需求命名.

html书写规范

1. 文档类型声明及编码: 统一为html5声明类型; 编码统一为utf-8, 书写时利用IDE实现层次分明的缩进;

2. 非特殊情况下样式文件必须外链;非特殊情况下JavaScript文件必须外链至页面底部;

3. 引入JS库文件, 文件名须包含库名称及版本号及是否为压缩版, 比如jquery-1.4.1.min.js; 引入插件, 文件名格式为库名称+插件名称, 比如jQuery.cookie.js。

4. 充分利用无兼容性问题的html自身标签, 比如span, em, strong, optgroup, label,等等不要总频繁使用空div。

5. 语义化html,头部header尾部footer文档区域section等。

6. 尽可能减少div嵌套。

7. 在页面中尽量避免使用行内样式。

8. 必须为含有描述性表单元素(input, textarea)添加label。

9. 重要图片必须加上alt属性; 给重要的元素和截断的元素加上title。

10. 给区块代码及重要功能(比如循环)加上注释, 方便后台阅读。

css书写规范

1. 编码统一为utf-8;

2. 编写公用模块css文件,主要包括reset部分和公用模块css,提高代码重用率。

3.注意css和id的使用样式部分大部分重用率高的用class,id主要用于标识大的区域和js的使用。

4. 为JavaScript预留钩子的命名, 请以 js_ 起始, 比如: js_hide, js_show。

5. 背景图片请尽可能使用sprite技术, 减小http请求。

6. 减少使用影响性能的属性, 比如position:absolute || float ;

7. 必须为大区块样式添加注释, 小区块适量注释;

JavaScript书写规范

1. 文件编码统一为utf-8,。

2. 驼峰式命名,命名语义化。

3. 原则上要求原生开发。

4. 代码结构明了, 加适量注释. 提高函数重用率。

5. 注重与html分离, 减小reflow, 注重性能。

注释规范

1. html注释: 注释格式 , ’–’只能在注释的始末位置,不可置入注释文字区域;

2. css注释: 注释格式 /*这儿是注释*/;

3. JavaScript注释, 单行注释使用’//这儿是单行注释’ ,多行注释使用 /* 这儿有多行注释 */;

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • Web前端开发规范文档 规范目的: 使开发流程更加规范化。 通用规范: TAB键用两个空格代替(WINDOWS下T...
    荞叶阅读 551评论 0 1
  • 基本准则 符合web标准,html语义化;html,css,JavaScript分离;代码简洁有序,尽可能减少冗余...
    喵呜君阅读 820评论 0 1
  • 本文首发于我的个人网站:http://cherryblog.site/ (背景更换了不知道大家有没有发现呢,嘻嘻)...
    sunshine小小倩阅读 2,017评论 0 32
  • 开学一周我们一家人不断的听彼此分享着感受着你入学“二实验”的惊喜~~超级负责任的老师,可爱、出色的同学们,有...
    赵小亦阅读 841评论 0 1
  • 吾一莽夫,面墙之徒,腹中不过一二十卷书。天才钝拙,家世贫瘠,胸无点墨,顽劣至极,是以无为,皆因咎由自取。吾今日省,...
    your_Tien阅读 293评论 0 0