前台编码规范(Html,JS,CSS).docx

前台编码规范(Html,JS,CSS).docx

ID:59223998

大小:17.54 KB

页数:6页

时间:2020-09-09

前台编码规范(Html,JS,CSS).docx_第1页
前台编码规范(Html,JS,CSS).docx_第2页
前台编码规范(Html,JS,CSS).docx_第3页
前台编码规范(Html,JS,CSS).docx_第4页
前台编码规范(Html,JS,CSS).docx_第5页
资源描述:

《前台编码规范(Html,JS,CSS).docx》由会员上传分享,免费在线阅读,更多相关内容在教育资源-天天文库

1、密级:内部1引言21.1编写目的21.2变更记录21.3定义21.4参考资料22HTML22.1命名22.2标签32.3排版32.4CSHTML33JS33.1组织33.2命名43.3变量43.4方法43.5对象及控件43.6第三方库43.7排版43.8AJAX54CSS54.1组织54.2命名54.3兼容性54.4第三方库64.5排版6前台编码规范1引言1.1编写目的帮助开发团队形成一致的前台编码风格,并指出某些容易引发BUG的不良编码习惯,预期读者为长沙安晨信息科技有限公司的全体开发人员。1.2变更记录版本号作者日期备注1.0Aaron7/1/20141.1Aaron

2、7/31/2014Addexamples1.2Aaron8/4/2014Updatetheformat1.3定义术语定义备注HTMLHypertextMarkupLanguageJSJavascriptCSSCascadingStyleSheet1.4参考资料2HTML2.1命名·文件名采用帕斯卡命令法,所有单词首字母大写,词汇缩小可以全部大写,单词间不加任何连接符。例如“UserLogin.cshtml”·文件名应见名知义,能清晰描述页面主要功能,例如“AddUser.cshtml”。2.2标签·所有标签都应该正确关闭,例如“

”,无子元素及内容的

3、标签,可根据W3C规范简化为自关闭标签,例如“”,但有部分自关闭标签兼容性较差,在无法确认的情况下,都应该使用双标签关闭。例如标签在IE浏览器中可能无法加载背景图片。·为确保兼容性及用户体验一致性,应尽量避免使用以下过时标签:
。此外,不要将

标签用于页面布局。·应尽量避免使用自定义标签名,以增强可读性和可维护性。·完整的独立*tml页面,应该内含
标签,并在
中登记keywords,description等信息,以便于搜索引擎收录。2

4、.3排版·HTML标记内部,不允许出现空行及无意义的空格。·应正确使用缩进来呈现嵌套关系,子元素应比父级元素缩进一个制表位。但仅有内容无子标签的元素,可在同一行书写,例如“”。·如标签属性过多过长,可适当在标签内部换行,但同一页面,同类标签应采用大致相同的换行策略,切忌五花八门。2.4CSHTML·向控件赋值应尽量直接使用标准的Model,ViewData或ViewBag,如非必要,不要使用@{}嵌入块,尤其是不要在嵌入块中进行无意义的重复引用,例如“@{vartest=@ViewBag.Test;}”。·@Html生成器存在多个

5、兼容性问题,应谨慎使用,简单的控件应尽可能使用原生html标签。例如@Html.DropDownList在绑定已有选中值的数据源时,会丢失已选中项。3JS3.1组织·应尽可能将JS代码写入独立的JS文件中,而不要直接嵌入页面,以增强缓存利用率及可维护性。·相同或类似算法应尽可能统一到同一个方法中,以提高可维护性。尤其是不允许在Creat和Edit页面之间直接Copy相关JS代码。·在页面中引用JS文件时,应将引用标签写在标签之后。·项目正式发布时,应将所有JS文件转化为mini版本。3.2命名·文件名全部小写(词汇缩写也小写),各单词间用“-”为连接符。例如“

6、jquery-overlay-1.0.js”·方法名,变量名均采用骆驼命名法,第一个单词小写,之后的单词首字母大写,各单词间不加任何连接符。例如“userId”·所有变量及方法名都应见名知义,除i,j,k等约定俗成用于集合遍历的临时变量名以外,不允许使用无意义的单个字母做为变量名或方法名。3.3变量·JS有着非常糟糕的内存及作用域管理机制,如非绝对必要,不要声明全局变量。3.4方法·为提高兼容性,尽可能少使用returnfalse;应以e.preventDefault();代替。3.5对象及控件·公司目前无专职前台工程师,JS平均水平偏低。而JS自定义对象及控件语法比较复

7、杂,为增强项目可维护性,应尽量避免使用自定义对象及控件,在必要情况下,也应先与整个团队协商。3.6第三方库·为增强可维护性,原则上各项目都采用Jquery或AngularJSframework为基础库,以确保所有人都能看懂相关代码。·在项目中引入第三方JS插件时,应与整个团队协商,并认真评估兼容性。·如无绝对正当的理由,同一个项目中,不应该出现同一JS库的不同版本。·项目中引用的任何第三方JS文件均应存放于独立文件夹中,并不得直接修改原始文件,如果需要扩充或修改第三方API,应写在另外的文件中。如引用的第三方JS库较多,应在项

当前文档最多预览五页,下载文档查看全文

此文档下载收益归作者所有

当前文档最多预览五页,下载文档查看全文
温馨提示:
1. 部分包含数学公式或PPT动画的文件,查看预览时可能会显示错乱或异常,文件下载后无此问题,请放心下载。
2. 本文档由用户上传,版权归属用户,天天文库负责整理代发布。如果您对本文档版权有争议请及时联系客服。
3. 下载前请仔细阅读文档内容,确认文档内容符合您的需求后进行下载,若出现内容与标题不符可向本站投诉处理。
4. 下载文档时可能由于网络波动等原因无法下载或下载错误,付费完成后未能成功下载的用户请联系客服处理。