欢迎来到天天文库
浏览记录
ID:21826567
大小:135.04 KB
页数:13页
时间:2018-10-25
《web前端开发代码使用规范》由会员上传分享,免费在线阅读,更多相关内容在学术论文-天天文库。
1、WEB前端代码规范规范目的为提高团队协作效率,便于后台人员添加功能及前端后期优化维护,输出高质量的文档,特制订此文档。木规范文档一经确认,前端开发人员必须按木文档规范进行前台页面开发。木文档如有不对或者不合适的地方请及吋提出,经讨论决定后方可更改。基本准则符合web标准;语义化html;结构、表现、行为分离;兼容性优页面性能方面,代码要求简洁明了有序,尽可能的减小服务器负载,保证最快的解析速度。文件规范1.Html,css,js,images文件均归档至相应约定的目录中cssimagesbackstagejs后台投块.cssWebRootimagesfrontStageVJSWEB-I
2、NF前台模块.1.html文件命名:英文驼峰式命名,文件名.html。按实际模块需求命名。2.jsp文件命名:英文驼峰式命名,文件名.jsp。按实呩模块需求命名。3.css文件命名:英文驼峰式命名,文件名.css。共用base,css,首贞index,css,其他页而按实际模块需求命名。4.js文件命名:英文驼峰式命名,文件名.js。共用common,js,其他依实际模块需求命名。html书写规范1.文档类型声明及编码:统一为html5的声明类型
3、5写时利用IDE实现S次分明的缩进。2.非特殊情况卜*
4、css文件必须在〈head〉...〈/head〉之间引入,选择link方式引入而非©import形式。3.非特殊情况下js文件必须在页面底部引入。4.引入样式文件或JavaScript文件吋,须略去默认类型声明,写法如下:<1inkrel=〃stylesheet〃href=〃…〃/〉〈style〉...5.引入JS库文件,文件名须包含库名称及版本号及是否为压缩版,比如:jquery-1.4.1.min.js;6.引入插件,文件名格式为库名称+插件名称,比如:jQuery.cookie.jso7.所宥HTML标签嵌套必须是.
5、
6、卜:确的,禁止出现多出或者少出闭合标签的情况。8.所有编码均遵循xhtml标准,标签、属性、属性命名必须由小写字母及下划线数字组成,且所有标签必须闭合,包括br(〈br/〉),hr(〈hr/>)等;属性值必须用双引号包括。9.充分利用无兼容性问题的html自身标签,比如span、em、strong、optgroup、label10.11.12.13.14.15.16.需要为html元素添加自定义属性的时候,首先要考虑下有没有默认的已有的合适标签去设置,如果没有,须以"data-"为前缀来添加自定义属性,避免使用"data:〃等其他命名方式。语义化html,如标题根据重要性用hl-h6
7、(同一页面只能有一个hl),段落标记用p,歹IJ表用ul,内联元素中不可嵌蕓块状元素。尽可能减少div的嵌套层数。在页而中尽量避免使用内嵌样式表,即在标签内使用styles"…"。以背景形式呈现的图片,尽量写入cm样式中;重要图片必须加上alt属性;特殊符号使用:尽可能使用代码替代:比如<(<)、〉(>)、空格( )、&(&)、”(")等等;尽量避免使用过度复杂的HTML结构。CSS书写规范1.编码统•一为utf-8。2.为丫避免一些浏览器兼容性问题以及增加样式重用性,每个页面必须引入base,css(详见附件一),此文件不可随意修改。3.cla
8、ss与id的使用:id是唯一的并是父级的,class是可以重复的并是子级的,所以id仅使用在大的模块上,class可用在重复使用率高及子级中。4.为JavaScript预留钩子的命名,请以js_起始,比如:js_hide,js_show05.class与id命名:使用英文命名,命名要语义化,简明化,但不耍使用诸如first,last之类的命名。使用驼峰式和下划线分隔相结合的命名规则,即命名应以父级加子级的命名规范,如:父级的类为simple子级的类应该为simple_first,以此类推,但是尽量避免岀现超过四级的类命名。6.css属性书写顺序,建议遵循:自身属性一>布局定位属性一>文
9、木属性一>其他属性。此条可根据自身习惯书写,但尽量保证同类属性写在一起。属性列举:自身属性主要包括:width、height、margin、padding、border、background;布局定位属性主要包括:display>list-style、position(相应的top、right、bottom、left)、float、clear、visibility、overflow;文木属性主要包括:color、font、text-decora
此文档下载收益归作者所有