欢迎来到天天文库
浏览记录
ID:41789811
大小:59.85 KB
页数:12页
时间:2019-09-02
《WEB前端开发代码使用要求规范》由会员上传分享,免费在线阅读,更多相关内容在工程资料-天天文库。
1、实用文档WEB前端代码规范规范目的为提高团队协作效率, 便于后台人员添加功能及前端后期优化维护,输出高质量的文档,特制订此文档。本规范文档一经确认,前端开发人员必须按本文档规范进行前台页面开发。本文档如有不对或者不合适的地方请及时提出,经讨论决定后方可更改。基本准则符合web标准;语义化html;结构、表现、行为分离;兼容性优良。页面性能方面,代码要求简洁明了有序,尽可能的减小服务器负载,保证最快的解析速度。文件规范1.Html,css,js,images文件均归档至相应约定的目录中。2.html文件命名:英文驼峰式命名,文件名.html。按实际模块需求命名。文案大全实用文
2、档1.jsp文件命名:英文驼峰式命名,文件名.jsp。按实际模块需求命名。2.css文件命名:英文驼峰式命名,文件名.css。共用base.css,首页index.css,其他页面按实际模块需求命名。3.js文件命名:英文驼峰式命名,文件名.js。共用common.js,其他依实际模块需求命名。html书写规范1.文档类型声明及编码: 统一为html5的声明类型;编码统一为,书写时利用IDE实现层次分明的缩进。2.非特殊情况下css文件必须在
3、引入而非@import形式。3.非特殊情况下js文件必须在页面底部引入。4.引入样式文件或JavaScript文件时,须略去默认类型声明,写法如下:5.引入JS库文件,文件名须包含库名称及版本号及是否为压缩版,比如:jquery-1.4.1.min.js;6.引入插件,文件名格式为库名称+插件名称,比如:jQuery.cookie.js。7.所有HTML标签嵌套必须是正确的,禁止出现多出或者少出闭合标签的情况。8.所
4、有编码均遵循xhtml标准,标签、属性、属性命名必须由小写字母及下划线数字组成,且所有标签必须闭合,包括br(),hr(
5、l,内联元素中不可嵌套块状元素。2.尽可能减少div的嵌套层数。3.在页面中尽量避免使用内嵌样式表,即在标签内使用style="…"。4.以背景形式呈现的图片,尽量写入css样式中;重要图片必须加上alt属性;5.特殊符号使用:尽可能使用代码替代:比如<(<)、>(>)、空格( )、&(&)、”(")等等;6.尽量避免使用过度复杂的HTML结构。css书写规范1.编码统一为utf-8。2.为了避免一些浏览器兼容性问题以及增加样式重用性,每个页面必须引入base.css(详见附件一),此文件不可随意修改。3.class与id的使用:id
6、是唯一的并是父级的,class是可以重复的并是子级的,所以id仅使用在大的模块上,class可用在重复使用率高及子级中。4.为JavaScript预留钩子的命名,请以js_起始,比如:js_hide,js_show。5.class与id命名:使用英文命名,命名要语义化,简明化,但不要使用诸如first,last之类的命名。使用驼峰式和下划线分隔相结合的命名规则,即命名应以父级加子级的命名规范,如:父级的类为simple子级的类应该为simple_first,以此类推,但是尽量避免出现超过四级的类命名。6.css属性书写顺序,建议遵循:自身属性-->布局定位属性-->文本属性
7、-->其他属性。此条可根据自身习惯书写,但尽量保证同类属性写在一起。属性列举: 自身属性主要包括:width、height、margin、padding、border、background;布局定位属性主要包括:display、list-style、position(相应的top、right、bottom、left)、float、clear、visibility、overflow; 文本属性主要包括:color、font、text-decoration、text-align、vertical-align、white
此文档下载收益归作者所有