WEB前端代码规范规范目的为提高团队协作效率, 便于后台人员添加功能及前端后期优化维护,输出高质量的文档,特制订此文档。本规范文档一经确认,前端开发人员必须按本文档规范进行前台页面开发。本文档如有不对或者不合适的地方请及时提出,经讨论决定后方可更改。基本准则符合web标准;语义化html;结构、表现、行为分离;兼容性优良。页面性能方面,代码要求简洁明了有序,尽可能的减小服务器负载,保证最快的解析速度。文件规范Html,css,js,images文件均归档至相应约定的目录中。html文件命名:英文驼峰式命名,。按实际模块需求命名。jsp文件命名:英文驼峰式命名,。按实际模块需求命名。css文件命名:英文驼峰式命名,。,,其他页面按实际模块需求命名。js文件命名:英文驼峰式命名,。,其他依实际模块需求命名。html书写规范文档类型声明及编码: 统一为html5的声明类型<!DOCTYPE html>;编码统一为<meta charset="utf-8"/>,书写时利用IDE实现层次分明的缩进。非特殊情况下css文件必须在<head>...</head>之间引入,选择link方式引入而非***@import形式。非特殊情况下js文件必须在页面底部引入。引入样式文件或JavaScript文件时,须略去默认类型声明,写法如下:<link rel="stylesheet" href="..."/><style>...</style><script src="..."></script>引入JS库文件,文件名须包含库名称及版本号及是否为压缩版,比如:jquery-;引入插件,文件名格式为库名称+插件名称,比如:。所有HTML标签嵌套必须是正确的,禁止出现多出或者少出闭合标签的情况。所有编码均遵循xhtml标准,标签、属性、属性命名必须由小写字母及下划线数字组成,且所有标签必须闭合,包括br(<br />),hr(<hr />)等;属性值必须用双引号包括。充分利用无兼容性问题的html自身标签,比如span、em、strong、optgroup、label……需要为html元素添加自定义属性的时候,首先要考虑下有没有默认的已有的合适标签去设置,如果没有,须以"data-"为前缀来添加自定义属性,避免使用"data:"等其他命名方式。语义化html,如标题根据重要性用h1-h6(同一页面只能有一个h1),段落标记用p,列表用ul,内联元素中不可嵌套块状元素。尽可能减少div的嵌套层数。在页面中尽量避免使用内嵌样式表,即在标签内使用style="…"。以背景形式呈现的图片,尽量写入css样式中;重要图片必须加上alt属性;特殊符号使用:尽可能使用代码替代:比如<(<)、>(>)、空格( )、&(&)、”(")等等;尽量避免使用过度复杂的HTML结构。css书写规范编码统一为utf-8。为了避免一些浏览器兼容性问题以及增加样式重用性,(详见附件一),此文件不可随意修改。class与id的使用:id是唯一的并是父级的,class是可以重复的并是子
WEB前端开发代码使用规范 来自淘豆网m.daumloan.com转载请标明出处.
