Web前端开发规范
1. 规范概述
1.1. 目的
为提高团队协作效率,便于后台人员添加功能及前端后期优化维护,输出高质量的文档,特制订此文档。本规范文档一经确认,前端开发人员必须按本文档规范进行前台页面开发。本文档如有不对或者不合适的地方请及时提出,经讨论决定后方可更改。 1.2. 准则
符合web标准,语义化html,结构表现行为分离,兼容性优良。页面性能方面,代码要求简洁明了有序,尽可能的减小服务器负载,保证最快的解析速度。
2. 文件规范
2.1. 基本要求
1) 对页面中标签属性的值都需要用双引号包括起来 2) 所有页面编码均采用utf-8 2.2. 文件存放与命名规范
1) html,css,js,images文件均归档至《系统开发规范》约定的目录中;
2) html文件命名:英文命名,后缀.htm,同时将对应界面稿放于同目录中, 并要求与html
文件同名,以方便后端添加功能时查找对应页面;
3) css文件命名:英文命名,后缀.css,共用base.css,首页index.css,其他页面依
实际模块需求命名;
4) js文件命名:英文命名,后缀.js,共用common.js,其他依实际模块需求命名。 2.3. html书写规范
1) 文档类型声明及编码:统一为html5声明类型;编码统一为
charset=\,书写时利用IDE实现层次分明的缩进; 2) 非特殊情况下样式文件必须外链至
...之间;非特殊情况下JavaScript文件必须外链至页面底部;
3) 引入样式文件或JavaScript文件时,须略去默认类型声明,写法如下:
...