以服务提升价值,做中国最受信赖的网络服务提供商。
WEB 前端开发规范文档
规范目的
为提高团队协作效率, 便于后台人员添加功能及前端后期优化维护, 输出高质量的文档, 特制订此文档。 本规范文
档一经确认, 前端开发人员必须按本文档规范进行前台页面开发。 本文档如有丌对戒者丌合适的地方请及时提出,经讨论
决定后方可更改。
基本准则
符合 web 标准,语义化 html, 结构、表现、行为分离, 兼容性优良。 页面性能方面, 代码要求简洁明了有序, 尽
可能的减小服务器负载, 保证最快的解析速度。
文件规范
1. html、css、javascript、images 文件均归档至《WEB 前端开发规范文档》约定的目录中。
2. html 文件命名: 英文命名, 后缀为“.html”。 同时将对应界面稿放于同目录中,若界面稿命名为中文,请重命名不
html 文件同名,以方便后端添加功能时查找对应页面。
3. css 文件命名: 英文命名,共用: base.css,首页: homepage.css,子页 subpage.css,框架样式:
layoout.css ,其它页面依实际模块需求命名。
4. Javascript 文件命名: 英文命名, 共用 common.js, 其他依实际模块需求命名。
html 书写规范
1. 代码根据元素嵌套关系采用 TAB 键进行缩进,以减少代码字符量。
2. 所有编码均遵循 xhtml 标准,所有标签必须闭合,包括 br (<br />) 、hr(<hr />)等;属性值必须用双引号包括。
3. DTD type 采用相对稳定的过滤类型(Transitional):
<!DOCTYPE html PUBLIC “-//W3C//DTD XHTML 1.0 Transitional//EN”
“http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd”>
4. 编码统一为:<meta http-equiv=”Content-Type” content=”text/html; charset=utf-8” /> 。
5. 元标记的顺序是 meta 放在 title 的前面。
6. meta 标签 http-equiv 属性的顺序:
Content-Type -> Content-Language -> ROBOTS -> keywords -> descrition