一、文件命名规则

文件名称统一用小写的英文字母、数字和下划线的组合，其中不得包含汉字、空格和特殊字符；命名原则的指导思想一是使得你自己和工作组的每一个成员能够方便的理解每一个文件的意义，二是当我们在文件夹中使用“按名称排例”的命令时，同一种大类的文件能够排列在一起，以便我们查找、修改、替换、计算负载量等等操作。

1 HTML的命名原则

引文件统一使用index.htm index.html index.ASP文件名（小写）各子页命名的原则首先应该以栏目名的英语翻译取单一单词为名称。例如：

如果栏目名称多而复杂并不好以英文单词命名，则统一使用该栏目名称拼音或拼音的首字母表示；每一个目录中应该包含一个缺省的html 文件，文件名统一用index.htm index.html index.asp；2 图片的命名原则

图片的名称分为头尾两部分，用下划线隔开，头部分表示此图片的大类性质例如：广告、标志、菜单、按钮等等。

范例：banner_sohu.gif banner_sina.gif menu_aboutus.gif menu_job.gif Title_news.gif logo_police.gif logo_national.gif pic_people.jpg鼠标感应效果图片命名规范为"图片名 _ on/off"。例如：menu1_on.gif menu1_off.gif3 javascript的命名原则

例如：广告条的javaSCRIPT文件名为 ad.js

弹出窗口的javascript文件名为 pop.js4 动态语言文件命名原则

以性质_描述，描述可以有多个单词，用“_”隔开，性质一般是该页面的概要。

范例：register_form.asp register_post.asp topic_lock.asp

二、文件存放位置规范

web前端开发必备技术（Web前端的一些开发规范）(1)

三、CSS 书写规范

1.基本原则

CSS样式可细分为3类：自定义样式、重新定义html样式、链接状态样式。

（1） 样式为设计师自定义的新 CSS 样式，影响被使用本样式的区域，用于完成网页中局部的样式设定。

样式名 “.” “相应样式效果描述的单词或缩写”例：“ .shadow ”文字样式样式名“.no” “字号” “行距” “颜色缩写”例：“ .no12 ” 、“ .no12-24 ”

（2） 义HTML样式为设计师重新定义已有的HTML标签样式，影响全部的被设定标签样式，用于统一网页中某一标签的样式定义。

样式名“HTML标签”例：hr { border: 1px dotted #333333}

（3） 态样式为设计师对链接不同状态设定特殊样式，影响被使用本样式区域中的链接。该样式写法有2种： a.nav:link nav.a:link 第一种只能修饰<a>标签中；第二种可以修饰所有包含有<a>标签的其他标签。

页面内的样式加载必须用链接方式<link rel="stylesheet" type="text/css" href="style/style.css">

2.注意细则

（1）class与id的使用

id是唯一的并是父级的, class是可以重复的并是子级的, 所以id仅使用在大的模块上, class可用在重复使用率高及子级中; id原则上都是由我分发框架文件时命名的, 为JavaScript预留钩子的除外;

（2）为JavaScript预留钩子的命名, 请以 js_ 起始, 比如: js_hide, js_show;

（3）class与id命名

小写英文 & 数字 & _ 来组合命名, 如i_comment, fontred, width200; 避免使用中文拼音, 尽量使用简易的单词组合; 总之, 命名要语义化, 简明化.

（4）规避class与id命名:

（5）css属性书写顺序, 建议遵循 布局定位属性-->自身属性-->文本属性-->其他属性. 此条可根据自身习惯书写, 但尽量保证同类属性写在一起. 属性列举: 布局定位属性主要包括: margin、padding、float（包括clear）、position（相应的 top,right,bottom,left）、display、visibility、overflow等；自身属性主要包括: width & height & background & border; 文本属性主要包括：font、color、text-align、text-decoration、text-indent等；其他属性包括: list-style(列表样式)、vertical-vlign、cursor、z-index(层叠顺序) 、zoom等.

（6）书写代码前, 考虑并提高样式重复使用率;

（7）充分利用html自身属性及样式继承原理减少代码量, 比如:

<ul class="list"><li>这儿是标题列表<span>2010-09-15</span></ul>

定义ul.list li{position:relative} ul.list li span{position:absolute; right:0}

即可实现日期居右显示

（8）样式表中中文字体名, 请务必转码成unicode码, 以避免编码错误时乱码;

（9）背景图片请尽可能使用sprite技术, 减小http请求, 考虑到多人协作开发, sprite按模块制作;

（10）使用table标签时(尽量避免使用table标签), 请不要用width/ height/cellspacing/cellpadding等table属性直接定义表现, 应尽可能的利用table自身私有属性分离结构与表现, 如thead,tr,th,td,tbody,tfoot,colgroup,scope；

（11） 杜绝使用<meta http-equiv="X-UA-Compatible" content="IE=7" /> 兼容ie8;

（12）用png图片做图片时, 要求图片格式为png-8格式,若png-8实在影响图片质量或其中有半透明效果, 请为ie6单独定义背景:

background:none;_filter:progid:DXImageTransform.Microsoft.AlphaImageLoader(sizingMethod=crop, src=’img/bg.png’);

（13）避免兼容性属性的使用, 比如text-shadow || css3的相关属性;

（14）减少使用影响性能的属性, 比如position:absolute || float ;

（15）必须为大区块样式添加注释, 小区块适量注释;

3.命名规则

4.注释的写法

/* Footer */ 内容区 /* End Footer */

5.id的命名

(1)页面结构

(2)导航

(3)功能

重定义的最先，伪类其次，自定义最后，便于自己和他人阅读！

不同浏览器上字号保持一致，字号建议用点数pt和像素px来定义，pt一般使用中文宋体的9pt 和11pt，px一般使用中文宋体12px 和14.7px 这是经过优化的字号，黑体字或者宋体字加粗时，一般选用11pt 和14.7px 的字号比较合适。中英文混排时，尽可能的将英文和数字定义为verdana 和arial 两种字体。

四、html 书写规范

1. 网页制作细节——head区代码规范

head区是指HTML代码的<head>和</head>之间的内容。

（1）必须加入的标签

（2）可以选择加入的标签

2. 网页制作细节——字体

3. 网页制作细节——链接

4. 网页制作细节——表格

1px表格 style="border-collapse: collapse"实例如下：

<table border="1" cellspacing="0" width="32" height="32" style="border-collapse: collapse"bordercolor="#000000" cellpadding="0"> <tr> <td></td></tr> </table>

设置亮、暗边框颜色表格有亮边框（bordercolorlight）和暗边框（bordercolordark）两个属性可以对表格样式设置。

<table border="1" width="500" bordercolorlight="#000000" bordercolordark="#FFFFFF">

在写 <table> 互相嵌套时，严格按照的规范，对于单独的一个<table>来说，<table><tr>对齐，<td> 缩进两个半角空格，<td> 中如果还有嵌套的表格，<table>也缩进两个半角空格，如果<td>中没有任何嵌套的表格，</td> 结束标记应该与 <td> 处于同一行，不要换行，应该是这样的：

<td><img src=”../images/sample.gif”></td>

这是因为浏览器认为换行相当于一个半角空格，以上不规范的写法相当于无意中增加一个半角空格，如果确实有必要增加一个半角空格，也应该这样写：

<td><img src=”../images/sample.gif”> </td>

一个网页要尽量避免用整个一张大表格，所有的内容都嵌套在这个大表格之内，因为浏览器在解释页面的元素时，是以表格为单位逐一显示，如果一张网页是嵌套在一个大表格之内，那么很可能造成的后果就是，当浏览者敲入网址，他要先面对一片空白很长时间，然后所有的网页内容同时出现。如果必须这样做，请使用 <tbody>标记，以便能够使这个大表格分块显示

5. 网页制作细节——下载速度

6. 网页制作细节——include

7. 网页制作细节——Alt和Title

都是提示性语言标签，请注意它们之间的区别。

在浏览网页时，当鼠标停留在图片对象或文字链接上时，在鼠标的右下角有时会出现一个提示信息框。对目标进行一定的注释说明。在一些场合，它的作用是很重要的。

alt 用来给图片来提示的。Title用来给链接文字或普通文字提示的。

用法如下：

<p Title="给链接文字提示">文字</p> <a href="#" Title="给链接文字提示">文字</a> <img src="图片.gif" alt="给图片提示">

8. 网页制作细节——缓存

网页不会被缓存

HTM网页

<META HTTP-EQUIV="pragma" CONTENT="no-cache"> <META HTTP-EQUIV="Cache-Control" CONTENT="no-cache, must-revalidate"> <META HTTP-EQUIV="expires" CONTENT="0">

ASP网页

Response.Expires = -1 Response.ExpiresAbsolute = Now() - 1 Response.cachecontrol = "no-cache"

9. 网页制作细节——浏览器兼容性

创建站点时，应该明白访问者可能使用各种 Web 浏览器。在已知的其他设计限制下，尽可能将站点设计为具有最大的浏览器兼容性。

目前使用的 Web 浏览器有二十多种，大多数已发行了多个版本。即使只针对使用 Netscape Navigator 和 Microsoft Internet Explorer 的大多数 Web 用户，但应该确并不是每个人都在使用这两种浏览器的最新版本。

站点越复杂（在布局、动画、多媒体内容和交互方面），跨浏览器兼容的可能性就越小。例如，并非所有的浏览器都可以运行JavaScript。不使用特殊字符的纯文本页面或许能够在任何浏览器中正确显示，但比起有效地使用图形、布局和交互的页面，这样的页面在美感上可能要差得多。所以，应尽量在最佳效果设计和最大浏览器兼容性设计之间取得平衡。

所有的HTML 标签的属性都要用单引号或者双引号括起，即我们应该写 <a href=”url”> 而不 是 <a href=url>

10. 图片处理细节——banner

全尺寸banner为468X60px，半尺寸banner为234X60px，小banner为88X31px。另外120X90，120X60也是小图标的标准尺寸。全尺寸banner不超过14K。普遍的banner尺寸760X100，750X120，468X60，468X95，728X90，585X140次级页的pip尺寸360X300，336X280游标:100X100或120X120

11. 图片处理细节——LOGO的国际标准规范

为了便于INTERNET上信息的传播，一个统一的国际标准是需要的。实际上已经有了这样的一整套标准。其中关于网站的LOGO，目前有三种规格：

12. 图片处理细节——页面修饰图片处理

图片经过优化以加快下载的速度,有较佳的视觉空间效果，用图要与页面风格、页面内容相符；制作精美，细节处理得当。

五、JavaScript书写规范
  1. 书写过程中, 每行代码结束必须有分号; 原则上所有功能均根据XXX项目需求原生开发, 以避免网上down下来的代码造成的代码污染(沉冗代码 || 与现有代码冲突 || ...);
  2. 库引入: 原则上仅引入jQuery库, 若需引入第三方库, 须与团队其他人员讨论决定;
  3. 变量命名: 驼峰式命名. 原生JavaScript变量要求是纯英文字母, 首字母须小写, 如iTaoLun; jQuery变量要求首字符为'_', 其他与原生JavaScript 规则相同, 如: _iTaoLun; 另, 要求变量集中声明, 避免全局变量.
  4. 类命名: 首字母大写, 驼峰式命名. 如 ITaoLun;
  5. 函数命名: 首字母小写驼峰式命名. 如iTaoLun();
  6. 命名语义化, 尽可能利用英文单词或其缩写;
  7. 尽量避免使用存在兼容性及消耗资源的方法或属性, 比如eval() & innerText;
  8. 后期优化中, JavaScript非注释类中文字符须转换成unicode编码使用, 以避免编码错误时乱码显示;
  9. 代码结构明了, 加适量注释. 提高函数重用率;
  10. 注重与html分离, 减小reflow, 注重性能.
六、图片规范
  1. 所有页面元素类图片均放入img文件夹, 测试用图片放于img/demoimg文件夹;
  2. 图片格式仅限于gif || png || jpg;
  3. 命名全部用小写英文字母 || 数字 || _ 的组合，其中不得包含汉字 || 空格 || 特殊字符；尽量用易懂的词汇, 便于团队其他成员理解; 另, 命名分头尾两部分, 用下划线隔开, 比如ad_left01.gif || btn_submit.gif;
  4. 在保证视觉效果的情况下选择最小的图片格式与图片质量, 以减少加载时间;
  5. 尽量避免使用半透明的png图片(若使用, 请参考css规范相关说明);
  6. 运用css sprite技术集中小的背景图或图标, 减小页面http请求, 但注意, 请务必在对应的sprite psd源图中划参考线, 并保存至img目录下.
七、注释规范
  1. html注释: 注释格式 <!--这儿是注释-->, '--'只能在注释的始末位置,不可置入注释文字区域;
  2. css注释: 注释格式 /*这儿是注释*/;
  3. JavaScript注释, 单行注释使用'//这儿是单行注释' ,多行注释使用 /* 这儿有多行注释 */;
,