Web前端开发规范文档(cssjavascript)
WEB前端开发规范方案文档
WEB前端开发规范方案文档一、概述本文档旨在规范前端开发团队的开发流程和编码规范,以提高代码的可读性、可维护性和可扩展性。
本规范适用于Web前端开发工作,包括HTML,CSS和JavaScript等相关技术。
二、项目目录规范1.项目根目录下应包含以下文件或文件夹:- index.html:项目的入口文件;- css文件夹:存放项目的css文件;- js文件夹:存放项目的JavaScript文件;- images文件夹:存放项目的图片文件;- fonts文件夹:存放项目的字体文件;- libs文件夹:存放项目的第三方库文件;- README.md:项目的说明文档。
2.CSS文件命名规范- 使用小写字母和中划线来命名文件,如:main.css;- 使用语义化的名称来命名文件,如:reset.css;- 对于一些通用的样式文件,可以使用常见的名称,如:normalize.css。
3. JavaScript文件命名规范- 使用驼峰命名法来命名文件,如:app.js;- 使用语义化的名称来命名文件,如:utils.js;- 对于一些通用的JavaScript文件,可以使用常见的名称,如:jquery.js。
三、HTML规范2.缩进和换行- 使用两个空格的缩进来表示嵌套关系,不使用tab键;3.属性顺序- 属性应按照以下顺序书写:class、id、data-*、style、src、href、alt、title等。
四、CSS规范1.样式命名规范- 使用小写字母和中划线来命名样式,如:header-title;- 使用语义化的名称来命名样式,如:main-container;-避免使用缩写,提高代码的可读性和可维护性。
2.CSS选择器规范- 使用类选择器来选中元素,不使用id选择器,以免造成样式的耦合性和难以维护性;-避免使用通配符选择器;-避免使用嵌套选择器,以免造成样式的复杂性和性能问题。
3.代码注释规范-使用注释来说明代码的用途和作用;-使用块注释来注释一整段代码,使用行注释来注释一行代码。
前端开发规范文档
前端开发规范文档
《前端开发规范文档》
前端开发规范文档是在前端开发过程中非常重要的一部分,它对于整个团队的开发效率、代码质量和项目的可维护性都起着至关重要的作用。
一个好的前端开发规范文档可以帮助团队成员在开发过程中统一标准,规范流程,减少冗余代码,提高代码的可读性和可维护性。
首先,前端开发规范文档应该包括对于项目工程目录结构的规范,包括页面代码、公共组件、样式文件、脚本文件、静态资源等的组织方式,以及统一的命名规范和命名约定。
其次,文档应该明确规范前端代码的书写格式,包括HTML、CSS、JavaScript等文件格式的编码规范,同时也应该指定统
一的代码注释规范,以及对于代码缩进、空格、换行等方面的规范。
第三,前端规范文档还应该包括对于前端开发工具和框架的规范使用说明,比如对于代码检查工具、编译打包工具、性能优化工具、版本控制工具等的使用规范。
此外,对于前端项目的测试规范、部署规范、代码 review 规
范等也应该在文档中有所体现。
在跨团队协作的情况下,还应该包括团队内部和团队间的沟通和协作规范。
总的来说,一个好的前端开发规范文档,应该是能够帮助团队
成员规范前端代码书写、提高代码质量、减少维护成本,并且能够在不同的项目中复用的文档。
团队成员在遵循规范文档的同时,也应该能够在实践中不断完善文档,以适应项目的特定需求和团队的发展。
WEB前端开发代码使用要求规范
WEB前端开发代码使用要求规范1.编码规范- 使用标准的HTML、CSS和JavaScript语法。
-使用缩进和空格来提高代码的可读性。
-使用注释来解释代码的目的和功能。
2.文件和目录结构规范-使用有意义的文件和目录命名,方便其他开发人员寻找代码。
-在项目中使用统一的目录结构,例如将HTML文件存放在一个文件夹中,将样式文件存放在另一个文件夹中,以此类推。
3.HTML规范- 避免在HTML中直接写入样式和脚本代码,应将样式和脚本代码分离到对应的CSS和JavaScript文件中。
4.CSS规范-使用适当的选择器,避免过多的嵌套。
-避免使用内联样式,应将样式写在CSS文件中,以提高可维护性。
- 使用合适的样式命名规则,例如使用BEM(Block-Element-Modifier)命名规则,或其他约定俗成的命名规则。
5. JavaScript规范-使用合适的变量和函数命名,提高代码的可读性。
-避免使用全局变量,应将变量和函数封装在模块中。
- 使用严格模式(`use strict`),避免不规范的语法和行为。
- 避免使用`eval`和`with`等不安全的代码。
-在循环中使用合适的终止条件,避免死循环。
6.代码结构规范-代码应具有良好的组织结构,例如使用模块化的方式来组织代码。
-尽量遵循单一职责原则,每个函数和类应该只负责一件事情。
-提取重复的代码块,封装成函数或类,以提高代码的复用性。
-不要写过长的函数或类,应该根据需要进行拆分和重构。
7.注释规范-使用注释来解释代码的目的和功能,特别是代码的复杂部分。
-注释应该清晰、简洁,方便其他开发人员理解代码。
-避免使用无用的注释,注释应该随着代码的变化而更新。
总之,遵守WEB前端开发代码使用要求规范能够提高代码的质量和开发效率,减少错误和维护成本。
同时,还能提高团队合作的效率,方便其他开发人员理解和修改代码。
因此,在进行WEB前端开发时应该积极遵守和推崇相关规范。
前端开发规范手册
前端开发规范手册前端开发规范手册一、命名规范1. 文件名使用小写字母,多个单词使用中划线(-)进行连接。
2. 变量、函数、方法使用小驼峰命名法,首字母小写,后面单词首字母大写。
3. 常量全部大写,并用下划线(_)连接单词。
4. 类名使用大驼峰命名法,首字母大写,后面单词首字母大写。
二、HTML规范1. 使用语义化标签,减少无意义的div和span标签的使用。
2. 标签属性顺序:id > class > type > name > data-* > src > href > title > alt > role > aria-* > data-*。
3. 使用双引号作为属性值的引号。
4. 标签嵌套要正确闭合,避免出现多余的标签。
三、CSS规范1. 使用外部引入的方式,避免存在内联样式。
2. 使用reset.css或normalize.css进行初始化样式。
3. 使用类名方式,避免使用标签名和ID来进行样式定义。
4. 样式属性书写顺序:定位相关属性 > 盒模型属性 > 字体样式属性 > 表现属性。
5. 样式属性值为0时,不需要单位。
6. 缩写属性需要使用全称,不使用缩写形式。
四、JavaScript规范1. 使用严格模式:'use strict'。
2. 使用ES6规范进行编码,使用let和const代替var关键字。
3. 缩进使用四个空格。
4. 使用驼峰命名法进行变量和函数命名。
五、图片规范1. 图片格式使用JPEG、PNG或GIF。
2. 图片存放在img目录下,需要给图片命名,并将图片分门别类存放。
六、代码规范1. 代码注释要清晰明了,避免出现疑惑的地方。
2. 避免使用全局变量,避免污染全局命名空间。
3. 函数和方法要有明确的功能,避免功能过于庞杂。
4. 避免使用eval和with语句。
5. 在for循环中使用缓存循环长度。
Web前端开发规范文档
Web前端开发规范文档规范目的:•使开发流程更加规范化。
通用规范:•TAB键用两个空格代替(WINDOWS下TAB键占四个空格,LINUX下TAB键占八个空格)。
•CSS样式属性或者JAVASCRIPT代码后加“;”方便压缩工具“断句”。
•文件内容编码均统一为UTF-8。
•CSS、JAVASCRIPT中的非注释类中文字符须转换成unicode 编码使用, 以避免编码错误时乱码显示。
文件规范:•文件名用英文单词,多个单词用驼峰命名法。
•一些浏览器会将含有这些词的作为广告拦截,文件命名、ID、CLASS等所有命名避免以上词汇。
html书写规范:•为每个HTML页面的第一行添加标准模式(standard mode)的声明,确保在每个浏览器中拥有一致的展现。
<!DOCTYPE html>•文档类型声明统一为HTML5声明类型,编码统一为UTF-8。
<meta charset="UTF-8">•<HEAD>中添加信息。
<meta name="author"content="smile@kang.cool">//作者•<meta name="description" content="hello">//网页描述•<meta name="keywords" content="a,b,c">//关键字,“,”分隔•<meta http-equiv="expires" content="Wed, 26 Feb 1997 08:21:57 GMT">//设定网页的到期时间。
一旦网页过期,必须到服务器上重新调阅•<meta http-equiv="Pragma" content="no-cache">//禁止浏览器从本地机的缓存中调阅页面内容•<meta http-equiv="Window-target" content="_top">//用来防止别人在框架里调用你的页面•<meta http-equiv="Refresh"content="5;URL=/">//跳转页面,5指时间停留5秒网页搜索机器人向导。
前端开发设计规范文档
前端开发设计规范文档一、引言前端开发是为用户提供良好的用户体验和友好的界面而进行的开发工作。
为了保证开发的一致性和高效性,制定前端开发设计规范是至关重要的。
本文档旨在提供一套通用的前端开发设计规范,帮助团队成员在开发过程中更好地协同工作,并提供一致美观的用户体验。
二、命名规范1.文件和目录命名规范-使用小写字母和连字符"-",不使用大写字母、空格或下划线。
-确保文件和目录名称清晰、简洁且有意义。
2.变量和函数命名规范-使用有意义的英文单词或短语命名变量和函数。
-使用小驼峰命名法,即第一个单词首字母小写,后续单词首字母大写。
-避免使用过于简单的变量名,如a、b、x、y等。
3.CSS类和ID命名规范-使用英文单词或短语命名CSS类和ID。
-使用连字符"-"分隔单词,避免使用下划线。
-避免使用过于简单的类名或ID,如a、b、c等。
三、HTML规范1.DOCTYPE声明规范- 使用 HTML5 的 DOCTYPE 声明,即 <!DOCTYPE html>。
3.属性使用规范-使用双引号""包裹属性值。
-避免使用行内样式,优先使用外部CSS文件。
四、CSS规范1.选择器使用规范-使用类选择器和ID选择器,避免使用元素选择器。
-避免使用过于复杂的选择器,保持简洁性和性能。
2.样式书写规范-使用缩进和换行使样式代码更易读。
-按照属性的字母顺序排列样式规则。
- 使用简写属性,如 margin、padding、font等。
3.文件组织规范-将样式规则分别存放在不同的CSS文件中,便于维护和管理。
五、JavaScript 规范1.变量和常量声明规范- 使用 var、let 或 const 声明变量和常量,避免使用全局变量。
-尽量将变量声明和赋值放在同一行。
2.代码书写规范-使用缩进和换行使代码更易读。
-使用驼峰命名法命名变量、函数和对象属性。
-使用分号";"结束语句。
前端开发规范文档
前端开发规范文档一、概述。
本文档旨在规范前端开发工作,统一团队成员的开发风格,提高代码质量和可维护性。
在前端开发中,规范是非常重要的,它可以让团队成员之间的合作更加顺畅,代码更加易读易懂。
本规范文档将涵盖HTML、CSS、JavaScript等前端开发的相关规范,希望每位开发人员都能认真遵守。
二、HTML规范。
1. 文件命名规范。
文件名应使用小写字母,单词之间可以使用连字符“-”连接,例如,index.html、about-us.html。
文件名应简洁明了,不使用无意义的数字或字符。
2. 代码缩进规范。
使用两个空格进行代码缩进,不使用Tab键。
3. 标签规范。
标签名应使用小写字母。
标签属性值应使用双引号。
4. 注释规范。
在需要注释的地方使用<!--->进行注释。
5. 其他规范。
应尽量避免使用行内样式和行内脚本。
尽量减少标签的嵌套层级,保持HTML结构的简洁性。
三、CSS规范。
1. 文件组织规范。
将CSS文件统一放置在一个文件夹中,不要将CSS文件散落在各个目录中。
可以根据模块或页面的不同,将CSS文件拆分为多个文件,使用@import进行引入。
2. 类名规范。
类名应使用小写字母,单词之间可以使用连字符“-”连接,例如,header-nav、footer-content。
类名应简洁明了,不使用无意义的数字或字符。
3. 属性顺序规范。
CSS属性应按照一定的顺序书写,例如,布局定位属性、盒模型属性、文字排版属性、视觉效果属性等。
4. 其他规范。
尽量避免使用!important,除非必要情况下。
尽量使用缩写属性,减少代码量。
四、JavaScript规范。
1. 变量命名规范。
变量名应使用驼峰命名法,例如,myName、isShow。
变量名应简洁明了,不使用无意义的单个字母。
2. 代码缩进规范。
使用两个空格进行代码缩进,不使用Tab键。
3. 注释规范。
在需要注释的地方使用//进行单行注释,使用/ /进行多行注释。
WEB前端开发规范----css篇
WEB前端开发规范----css篇【1】css样式名的书写规则(页尾附常用模块命名)1.由数字、字母及符号_组成,且首字母不得是_ 。
例如:.header .leftMenu_bar2.驼峰标识书写规则或者"_"符连接规则。
例如:.topNav或者.top_nav3.定义字体样式时,比如字大小,可用"font" + 字体大小+ "字体单位"来定义:.font_12_px .font_14_pt .font_16_em等。
同理:font_simsun、font_microsoft、width_960、width_980、color_red、color_yellow、color_ff6600等。
【2】css属性的书写规则对于具有复合属性的css不允许拆开写,例如:margin-top:10px; margin-right:auto; margin-left:0px; margin-bottom:10px; 应写出:margin:10px auto 0px;【3】css属性的书写顺序建议遵循:布局定位属性->自身属性->文本属性-> 其他属性。
布局定位属性:float、position、top、bottom、left、right、display、visibility、overflow、clear、margin、padding等自身属性:width、height、background、border等文本属性:font、color、text-decoration、text-indent等其他属性:list-style-type、z-index、zoom、cursor等【4】避免使用html标签私有属性定义表现,如table中的align、cellspacing、cellpadding 等,用css对应的text-align、border-spacing、padding来定义【5】css组合的使用对于具有相同属性的多个选择符,禁止重复书写,可用英文逗号(,)隔开选择符。
web前端规范
web前端规范Web前端规范是指在开发网页前端时要遵循的一系列约定和规范。
遵循规范可以提高代码的可读性、可维护性和可重用性,加快开发进度,减少错误发生的可能,提高团队合作效率。
以下是一些常见的Web前端规范:1. HTML规范:- 使用语义化标签,如header、footer、nav等- 避免使用inline样式,使用外部CSS文件- 避免使用行内事件的方式绑定事件,推荐使用addEventlListener2. CSS规范:- 使用唯一的class命名规范,如BEM(Block Element Modifier)- 使用层叠样式表(CSS)命名空间,避免全局样式的影响- 避免使用!important,除非必要情况下- 注释清晰明了,标明样式的用途和作用范围3. JavaScript规范:- 使用驼峰命名法来命名变量、函数和对象- 使用严格模式"use strict"- 避免使用全局变量- 注释清晰明了,标明函数的参数和返回值4. 文件和目录规范:- 使用有意义的文件名,避免使用中文和特殊字符- 使用文件和目录的层级结构进行组织- 分离HTML、CSS和JavaScript代码,避免混写5. 性能优化规范:- 减少HTTP请求的次数,合并和压缩文件- 使用CSS Sprite来减少图片的请求- 尽量避免在DOM加载完成之后再加载JavaScript文件6. 兼容性规范:- 使用现代浏览器支持的HTML5和CSS3特性- 使用兼容性的JavaScript写法,避免使用不支持的语法和API7. 版本控制规范:- 使用版本控制系统(如Git)管理代码- 使用合适的分支管理策略- 提交规范的commit注释除了以上提到的规范外,还有很多其他的规范,如代码缩进、代码注释、错误处理等。
具体的规范可以根据项目和团队的需求进行调整和补充。
总结起来,Web前端规范是一系列的约定和规范,帮助开发团队更好地组织和管理代码,提高代码质量和团队合作效率。
前端开发设计规范文档
前端开发设计规范文档一、引言二、代码编写规范1.缩进和空格-使用2个空格作为一个缩进层级。
- 在每个关键词或运算符后添加一个空格,如if (condition) {}。
-每行代码的末尾都应该去掉多余的空格。
2.行长限制每行代码应控制在80个字符以内,避免过长的代码行导致代码难以阅读和理解。
3.注释-使用注释来解释代码的意图和逻辑。
-使用单行注释(//)来注释一行代码,使用多行注释(/*...*/)来注释一段代码。
-注释要保持与代码同步,当代码发生修改时,注释也应随之更新。
4.变量和函数命名- 使用驼峰命名法(camelCase)命名变量和函数。
变量和函数名应该清晰明确,能够准确表达其含义。
-避免使用缩写和简写,除非是常见的缩写或简写形式。
5.常量命名-使用全大写字母和下划线的命名方式命名常量。
-常量名要具有描述性,能够清晰表达其含义。
6.字符串引号-使用双引号("")包裹字符串,避免使用单引号('')。
7.条件判断和循环语句-在条件判断和循环语句中使用花括号({})包裹代码块,即使只有一行代码。
8.数据类型转换-使用严格相等运算符(===)进行数据类型和值的比较,避免使用弱相等运算符(==)。
三、组织结构规范1.文件和文件夹命名-文件和文件夹命名应该清晰明确,能够准确表达其内容。
-文件和文件夹的命名应使用小写字母、短划线和数字的组合,避免使用空格和特殊字符。
2.目录结构前端项目应该按照一定的目录结构进行组织,常见的目录结构如下:- src:项目源代码目录。
- assets:用于存放静态资源文件,如图片、字体等。
- styles:存放样式文件。
- scripts:存放脚本文件。
- pages:存放页面组件。
四、性能优化规范1.文件合并和压缩-将多个CSS和JS文件合并为一个文件,并进行压缩。
-使用工具和插件进行自动化合并和压缩操作。
2.图片优化- 使用适当的图像格式,如JPEG、PNG、WebP等,以提高图像加载速度。
前端开发规范文档
前端开发规范文档前端开发是指在网站、网页或移动端应用的开发过程中,负责用户界面的设计和开发的工作。
一个良好的前端开发规范可以提高团队的工作效率、降低错误率,并且方便后期的维护和扩展。
本文将介绍一些常见的前端开发规范。
一、HTML规范2.使用正确的缩进和格式:使用合适的缩进和换行,使HTML代码易于阅读和维护。
4. 使用语义化的类名和id名:类名和id名应该能够准确描述元素的作用和功能,避免使用无意义的名称。
二、CSS规范2. 避免使用!important:尽量避免使用!important来覆盖样式,应优先考虑调整选择器的优先级。
3.使用合适的样式复用方式:避免重复的代码,可以使用类名或父子选择器来复用样式。
4. 使用合适的尺寸单位:根据具体情况选择合适的尺寸单位,如px、em、rem等。
5. 使用CSS预处理器:可以使用Sass、Less或Stylus等CSS预处理器来提高开发效率和代码的可维护性。
三、JavaScript规范1. 使用严格模式:在JavaScript代码的开头使用"use strict"启用严格模式,以减少错误和提高代码质量。
2.使用合适的命名规范:变量、函数和类名应该具有描述性的名称,遵循驼峰命名法或下划线分隔符。
3.避免全局变量污染:尽量避免使用全局变量,可以通过使用模块化的方式来封装代码,或者使用命名空间。
4. 避免使用eval和with:避免使用eval函数和with语句,它们可能会引起安全问题和性能问题。
5.使用合适的循环和控制结构:使用合适的循环和控制结构来提高代码的可读性和性能,避免过多嵌套的层级。
四、代码管理规范1. 使用版本控制工具:使用Git等版本控制工具来管理代码的版本,方便团队协作和代码的追踪和回滚。
2.编写有意义的提交信息:每次提交代码时,应编写有意义的提交信息,描述本次提交的内容和目的。
3.周期性地进行代码审查:定期进行代码审查,发现和修复潜在的问题,提高代码质量和稳定性。
Web前端开发规范文档(cssjavascript)
最近开始着手网站的改版,因为是团队协作,所有需要注意很多地方,也为了让我们的代码更加规范特收集了一些Web前端开发规范规范目的为提高团队协作效率, 便于后台人员添加功能及前端后期优化维护, 输出高质量的文档, 特制订此文档. 本规范文档一经确认, 前端开发人员必须按本文档规范进行前台页面开发. 本文档如有不对或者不合适的地方请及时提出, 经讨论决定后方可更改.基本准则符合web标准, 语义化html, 结构表现行为分离, 兼容性优良. 页面性能方面, 代码要求简洁明了有序, 尽可能的减小服务器负载, 保证最快的解析速度.文件规范1. html, css, js, images文件均归档至<系统开发规范>约定的目录中;2. html文件命名: 英文命名, 后缀.htm. 同时将对应界面稿放于同目录中, 若界面稿命名为中文, 请重命名与html文件同名, 以方便后端添加功能时查找对应页面;3. css文件命名: 英文命名, 后缀.css. 共用base.css, 首页index.css, 其他页面依实际模块需求命名.;4. Js文件命名: 英文命名, 后缀.js. 共用common.js, 其他依实际模块需求命名. html书写规范1. 文档类型声明及编码: 统一为html5声明类型<!DOCTYPE html>; 编码统一为<meta charset="gbk" />, 书写时利用IDE实现层次分明的缩进;2. 非特殊情况下样式文件必须外链至<head>...</head>之间;非特殊情况下JavaScript文件必须外链至页面底部;3. 引入样式文件或JavaScript文件时, 须略去默认类型声明, 写法如下:<link rel="stylesheet" href="..." /><style>...</style><script src="..."></script>4. 引入JS库文件, 文件名须包含库名称及版本号及是否为压缩版, 比如jquery-1.4.1.min.js; 引入插件, 文件名格式为库名称+插件名称, 比如jQuery.cookie.js;5. 所有编码均遵循xhtml标准, 标签 & 属性 & 属性命名必须由小写字母及下划线数字组成, 且所有标签必须闭合, 包括br (<br />), hr(<hr />)等; 属性值必须用双引号包括;6. 充分利用无兼容性问题的html自身标签, 比如span, em, strong, optgroup, label,等等; 需要为html元素添加自定义属性的时候, 首先要考虑下有没有默认的已有的合适标签去设置, 如果没有, 可以使用须以"data-"为前缀来添加自定义属性,避免使用"data:"等其他命名方式;7. 语义化html, 如标题根据重要性用h*(同一页面只能有一个h1), 段落标记用p, 列表用ul, 内联元素中不可嵌套块级元素;8. 尽可能减少div嵌套, 如<div class="box"& gt;<div class="welcome">欢迎访问XXX, 您的用户名是<div class="name">用户名</div></div></div>完全可以用以下代码替代: <div class="box"><p>欢迎访问XXX, 您的用户名是<span>用户名</span></p></div>;9. 书写链接地址时, 必须避免重定向,例如:href="/", 即须在URL 地址后面加上“/”;10. 在页面中尽量避免使用style属性,即style="…";11. 必须为含有描述性表单元素(input, textarea)添加label, 如<p> 姓名: <input type="text" id="name" name="name" /></p>须写成:<p><label for="name">姓名: </label><input type="text" id="name" /></p>12. 能以背景形式呈现的图片, 尽量写入css样式中;13. 重要图片必须加上alt属性; 给重要的元素和截断的元素加上title;14. 给区块代码及重要功能(比如循环)加上注释, 方便后台添加功能;15. 特殊符号使用: 尽可能使用代码替代: 比如 <(<) & >(>) & 空格( ) & »(») 等等;16. 书写页面过程中, 请考虑向后扩展性;17. class & id 参见 css书写规范.css书写规范1. 编码统一为utf-8;2. 协作开发及分工: i会根据各个模块, 同时根据页面相似程序, 事先写好大体框架文件, 分配给前端人员实现内部结构&表现&行为; 共用css文件base.css由i 书写, 协作开发过程中, 每个页面请务必都要引入, 此文件包含reset及头部底部样式, 此文件不可随意修改;3. class与id的使用: id是唯一的并是父级的, class是可以重复的并是子级的, 所以id仅使用在大的模块上, class可用在重复使用率高及子级中; id原则上都是由我分发框架文件时命名的, 为JavaScript预留钩子的除外;4. 为JavaScript预留钩子的命名, 请以 js_ 起始, 比如: js_hide, js_show;5. class与id命名: 大的框架命名比如header/footer/wrapper/left/right之类的在2中由i统一命名.其他样式名称由小写英文 & 数字 & _ 来组合命名, 如i_comment, fontred, width200; 避免使用中文拼音, 尽量使用简易的单词组合; 总之, 命名要语义化, 简明化.6. 规避class与id命名(此条重要, 若有不明白请及时与i沟通):a, 通过从属写法规避, 示例见d;b, 取父级元素id/class命名部分命名, 示例见d;c, 重复使用率高的命名, 请以自己代号加下划线起始, 比如i_clear;d, a,b两条, 适用于在2中已建好框架的页面, 如, 要在2中已建好框架的页面代码<div id="mainnav"></div>中加入新的div元素,按a命名法则: <div id="mainnav"><div class="firstnav">...</div></div>,样式写法: #mainnav .firstnav{.......}按b命名法则: <div id="mainnav"><div class="main_firstnav">...</div></div>,样式写法: .main_firstnav{.......}7. css属性书写顺序, 建议遵循: 布局定位属性-->自身属性-->文本属性-->其他属性. 此条可根据自身习惯书写, 但尽量保证同类属性写在一起. 属性列举: 布局定位属性主要包括: display & list-style & position(相应的 top,right,bottom,left)& float & clear & visibility & overflow;自身属性主要包括:width & height & margin & padding & border & background;文本属性主要包括:color & font & text-decoration & text-align & vertical-align & white- space & 其他 & content;我所列出的这些属性只是最常用到的, 并不代表全部;8. 书写代码前, 考虑并提高样式重复使用率;9. 充分利用html自身属性及样式继承原理减少代码量, 比如:<ul class="list"><li>这儿是标题列表<span>2010-09- 15</span></ul>定义ul.list li{position:relative} ul.list li span{position:absolute; right:0}即可实现日期居右显示10. 样式表中中文字体名, 请务必转码成unicode码, 以避免编码错误时乱码;11. 背景图片请尽可能使用sprite技术, 减小http请求, 考虑到多人协作开发, sprite 按模块制作;12. 使用table标签时(尽量避免使用table标签), 请不要用width/ height/cellspacing/cellpadding等table属性直接定义表现, 应尽可能的利用table自身私有属性分离结构与表现, 如thead,tr,th,td,tbody,tfoot,colgroup,scope; (cellspaing及cellpadding的css控制方法:table{border:0;margin:0;border-collapse:collapse;} table th, table td{padding:0;} , b ase.css文件中我会初始化表格样式)13. 杜绝使用<meta http-equiv="X-UA-Compatible" content="IE=7" />兼容ie8;14. 用png图片做图片时, 要求图片格式为png-8格式,若png-8实在影响图片质量或其中有半透明效果, 请为ie6单独定义背景:_background:none;_filter:progid:DXImageTransform.Microsoft.AlphaImageLoader (sizingMethod=crop, src=’img/bg.png’);15. 避免兼容性属性的使用, 比如text-shadow || css3的相关属性;16. 减少使用影响性能的属性, 比如position:absolute || float ;17. 必须为大区块样式添加注释, 小区块适量注释;18. 代码缩进与格式: 建议单行书写, 可根据自身习惯, 后期优化i会统一处理;JavaScript书写规范1. 文件编码统一为utf-8, 书写过程过, 每行代码结束必须有分号; 原则上所有功能均根据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注释, 单行注释使用'//这儿是单行注释' ,多行注释使用 /* 这儿有多行注释 */;开发及测试工具约定建议使用Aptana || Dw || Vim , 亦可根据自己喜好选择, 但须遵循如下原则:1. 不可利用IDE的视图模式'画'代码;2. 不可利用IDE生成相关功能代码, 比如Dw内置的一些功能js;3. 编码必须格式化, 比如缩进;测试工具: 前期开发仅测试FireFox & IE6 & IE7 & IE8 , 后期优化时加入Opera & Chrome & Safari;建议测试顺序: FireFox-->IE7-->IE8-->IE6-->Opera-->Chrome-->Safari, 建议安装firebug及IE Tab Plus插件.其他规范1. 开发过程中严格按分工完成页面, 以提高css复用率, 避免重复开发;2. 减小沉冗代码, 书写所有人都可以看的懂的代码. 简洁易懂是一种美德. 为用户着想, 为服务器着想...。
(完整word版)WEB前端开发代码使用要求规范.docx
实用文档WEB前端代码规范规范目的为提高团队协作效率,便于后台人员添加功能及前端后期优化维护,输出高质量的文档,特制订此文档。
本规范文档一经确认,前端开发人员必须按本文档规范进行前台页面开发。
本文档如有不对或者不合适的地方请及时提出,经讨论决定后方可更改。
基本准则符合 web标准;语义化 html ;结构、表现、行为分离;兼容性优良。
页面性能方面,代码要求简洁明了有序,尽可能的减小服务器负载,保证最快的解析速度。
文件规范1.Html, css ,js ,images 文件均归档至相应约定的目录中。
cssimagesbackStagejs后台模⋯⋯cssWebRootimagesfrontStagejsWEB-INF前台模⋯⋯全局公共模⋯⋯2. html 文件命名:英文驼峰式命名,文件名.html 。
按实际模块需求命名。
3.jsp 文件命名:英文峰式命名,文件名 .jsp 。
按模需求命名。
4.css 文件命名:英文峰式命名,文件名 .css 。
共用 base.css ,首 index.css ,其他面按模需求命名。
5.js 文件命名:英文峰式命名,文件名 .js 。
共用 common.js,其他依模需求命名。
html 书写规范1. 文档型声明及:一html5的声明型<!DOCTYPE html>;一<meta charset="utf-8"/>,写利用IDE 次分明的。
2.非特殊情况下 css 文件必在 <head>...</head> 之引入, link 方式引入而非@import 形式。
3.非特殊情况下 js 文件必在面底部引入。
4.引入式文件或 JavaScript 文件,略去默型声明,写法如下:<link rel="stylesheet"href="..."/><style>...</style><script src="..."></script>5.引入 JS 文件,文件名包含名称及版本号及是否版,比如: jquery-1.4.1.min.js ;6.引入插件,文件名格式名称 +插件名称,比如: jQuery.cookie.js 。
前端开发设计规范文档
前端开发设计规范文档1.设计概述(200字)前端开发设计规范文档旨在为前端开发人员提供一套统一的设计规范,确保开发出的网页和应用具有高可读性、易维护性和跨浏览器兼容性。
本文档将涵盖HTML、CSS和JavaScript编码规范、文件结构规范、命名规范、注释规范等方面的内容。
2.文件结构规范(200字)为了确保项目的可维护性和可扩展性,文件结构规范起到了至关重要的作用。
在项目中,应该按照功能、模块或页面将文件进行划分,并使用合理的命名方式对文件进行命名。
目录结构应该清晰明了,新人可以迅速找到所需文件,并且易于扩展和维护。
3.HTML编码规范(300字)4.CSS编码规范(300字)CSS编码规范旨在统一样式代码的书写风格,方便团队成员的合作和代码维护。
应该遵循缩进、空格、换行等方面的规则,并为选择器、属性和值选择合适的命名方式。
另外,应该避免使用全局选择器、!important和浮动布局等容易引起样式冲突的属性和技术。
5. JavaScript编码规范(300字)JavaScript编码规范对于代码的可读性、可维护性和可扩展性有着重要的影响。
代码应该遵循统一的缩进和空格约定,并采用语义化的命名方式。
应该避免使用全局变量和隐式全局变量,同时对函数进行适当的封装和模块化处理。
另外,应该注重错误处理和代码注释,以便他人能够理解和维护代码。
6.命名规范(200字)良好的命名规范有助于团队成员理解代码的意图和结构。
在命名时应使用有意义的名词和动词,避免使用缩写和拼音,并使用统一的命名方式。
对于变量、函数、类和文件命名,应该遵循一定的命名约定,以提高代码的可读性和可维护性。
7.注释规范(200字)总结(100字)前端开发设计规范文档为前端开发人员提供了一套统一的设计规范,包括文件结构、HTML、CSS、JavaScript编码规范、命名规范和注释规范等方面的内容。
遵循这些规范将有助于提高代码的可读性、可维护性和跨浏览器兼容性,提高团队成员之间的合作效率。
WEB前端开发规范
WEB前端开发规范WEB前端开发规范一、命名规范1. HTML/CSS命名规范- 使用大写字母和小写字母的组合方式,不使用汉字、拼音或其他特殊字符。
- 使用有意义的命名,能够反映元素的用途或内容。
- 使用连字符"-"作为多个单词的分隔符。
- 避免使用复数形式命名。
2. JavaScript命名规范- 使用驼峰命名法,首字母小写。
- 类名首字母要大写。
- 命名要具有表达性,能明确表达出变量或函数的用途。
3. 图片命名规范- 使用有意义的命名,能够反映图片的内容或用途。
- 使用连字符"-"作为多个单词的分隔符。
- 图片命名中不要包含特殊字符或中文。
二、代码规范1. HTML规范- 使用语义化的标签,遵循W3C标准。
- 元素属性值使用双引号包裹。
- 缩进使用两个空格,不使用TAB键。
2. CSS规范- 尽量避免使用!important。
- 属性和值之间用一个空格隔开。
- 选择器和属性名使用全小写。
- 使用缩进和换行使代码具有良好的可读性。
3. JavaScript规范- 使用ESLint进行代码检查,并遵循检查结果进行修改。
- 使用分号结束语句。
- 使用const和let替代var。
- 使用模块化开发,避免全局变量的滥用。
4. 文件目录规范- 对于大型项目,建议按照模块和功能进行文件分层。
- 文件和文件夹命名要有意义,能够清晰表达文件的用途。
5. 注释规范- 对于重要的代码块、函数和类,添加必要的注释,解释其作用和用法。
- 注释要简洁明了,不要使用口语化的表达方式。
- 避免不必要或重复的注释。
三、性能优化1. CSS性能优化- 避免使用过多的样式表和多层嵌套。
合并和压缩CSS文件。
- 使用CSS Sprites合并图片。
- 避免使用纯色背景图片,使用CSS实现。
2. JavaScript性能优化- 代码压缩和合并,减少HTTP请求。
- 合理使用缓存,避免重复请求相同的数据。
前端开发设计规范文档
前端开发设计规范文档1.前言前端开发是构建用户界面的过程,它的设计和编写需要遵循一定的规范,以保证代码的可读性、可维护性和可扩展性。
本文档旨在提供一个前端开发的设计规范,帮助开发人员在设计和编写前端代码时遵循统一的规范。
2.命名规范2.1文件和文件夹命名-文件名使用小写字母,单词之间可以使用连字符“-”连接。
-文件夹名同样使用小写字母,单词之间使用连字符“-”连接。
2.2变量和函数命名- 变量和函数名使用驼峰命名法,即第一个单词首字母小写,后面的单词首字母大写。
例如:userInfo, getUserInfo。
2.3CSS类命名- CSS 类名使用连字符“-”连接,例如:main-container, login-button。
3.HTML规范3.2嵌套规范-HTML元素的嵌套应该保持良好的层次结构,不要过深嵌套。
-使用缩进保持结构清晰,增加代码的可读性。
4.CSS规范4.1使用外部样式表-将CSS样式写在外部样式表中,使代码可重用和维护。
4.2避免使用行内样式-避免在HTML元素上使用行内样式定义样式。
4.3样式规则的书写顺序-将样式规则按照从上到下的顺序书写,以保持结构清晰。
-先定义通用样式,再定义特定样式。
-按照样式的属性顺序书写,例如先写字体相关,再写颜色相关。
4.4使用CSS预处理器-使用CSS预处理器(如SASS或LESS)来提高CSS代码的可维护性和可扩展性。
5. JavaScript 规范5.1使用严格模式- 在 JavaScript 文件的开头添加 "use strict" 来启用严格模式。
5.2使用语义化的命名-使用有意义的变量和函数名,易于理解和维护。
5.3避免全局变量和函数-尽量避免使用全局变量和函数,以减少命名冲突和代码污染。
5.4缩进和空白符-使用合适的缩进和空白符来增加代码的可读性。
5.5注释规范-使用注释解释代码的意图和功能。
-在复杂的代码块前添加注释,帮助其他开发人员理解代码逻辑。
WEB前端开发规范方案文档
WEB前端开发规范方案文档一、引言为了保证团队协作开发的一致性和高效性,提高代码的可读性和可维护性,制定了本前端开发规范方案文档。
本文档旨在规范前端开发过程中的编码风格、命名规范、文件和目录结构、代码注释、代码组织等方面,以确保团队成员在开发过程中能够遵守一致的规范和标准。
二、编码风格1.缩进:使用四个空格进行缩进,禁止使用制表符进行缩进。
2.换行:每行代码长度不超过80个字符。
如果一行代码超过80个字符,应该进行合理的分行,使用续行符号(\)连接。
3.命名:变量、函数、方法和类应使用驼峰命名法,且具有描述性,易于理解。
四、文件和目录结构1.目录结构:项目应根据不同模块和功能进行合理的目录结构划分,保持结构层次清晰且易于维护。
2.文件命名:文件名应具有描述性,易于理解,并使用小写字母和短横线进行单词分隔。
五、代码注释1.单行注释:在注释前应添加双斜杠(//),注释与代码之间保留一个空格。
注释应具有描述性,解释代码的功能和目的。
2.多行注释:在注释的前后使用斜杠星号(/*)进行包围,注释与代码之间保留一个空格。
注释应具有描述性,解释代码的功能和目的。
六、代码组织2.函数和方法:函数和方法应具有单一的功能,不应超过100行代码。
七、版本控制1. 使用git进行代码版本控制,每个开发人员在本地创建新分支进行开发,分支命名应明确描述开发内容。
2.开发完成后,将分支合并到主分支,进行代码审查。
八、测试1.所有的代码修改和新代码都需要进行测试,确保功能正常、稳定可靠。
2.使用自动化测试工具进行测试,在代码提交前进行自动化测试,减少出错概率。
九、代码重构1.定期进行代码重构,删除无用代码、优化性能和可读性较差的代码,并做好相应的注释和文档记录。
十、总结以上是本前端开发规范方案文档的内容,通过遵守本规范,可以提高团队协作开发的效率和代码质量。
同时,规范的编码风格、命名规范、文件和目录结构、代码注释、代码组织等方面也更便于后续的代码维护和项目迭代。
WEB前端开发规范文档
WEB前端开发规范文档一、命名规范1. 文件和文件夹名使用小写字母和短横线命名,例如:index.html2. CSS类名使用小写字母和短横线命名,例如:header-section3. JavaScript变量使用驼峰命名法,例如:userName4. 函数名使用驼峰命名法,例如:getUserInfo5.常量名全部大写,并使用下划线分隔,例如:MAX_COUNT6. HTML id和name属性使用小写字母和短横线命名,例如:user-name二、代码风格1.缩进使用四个空格2. CSS、JavaScript代码使用分号结尾3.避免使用全局变量,尽量使用局部变量4.函数和条件语句使用花括号包裹5.注释注明代码的功能和注意事项,方便他人阅读代码6.使用合适的空格和换行符,增强代码的可读性三、HTML规范2. 为所有的图片和链接添加alt属性,以提高可访问性3.避免使用行内样式,使用CSS样式表来管理样式4. 使用语义化的class和id名称,以增强代码可读性和可维护性四、CSS规范1.避免使用行内样式2. 在选择器中不要使用ID选择器,尽量使用class选择器3. 使用属性值缩写来减少代码量,例如:margin: 10px 5px;4. 避免使用!important,除非必要5. 建议使用CSS预处理器,如Sass或Less6. 使用CSS reset或normalize来统一各个浏览器的样式差异7. 书写顺序:布局属性 > 自身属性 > 文本属性 > 其他属性,例如:display, width, height, margin, padding, font-size, color五、JavaScript规范1. 使用严格模式,即在脚本文件的开头添加"use strict"2. 使用let和const关键字来声明变量和常量,避免使用var3. 使用单引号来定义字符串,例如:'Hello'4.避免使用全局变量,尽量使用模块化的方式组织代码5. 避免使用eval、with等容易引起安全问题的功能6. 使用ESLint来检查代码风格和潜在错误六、版本控制规范1. 使用git来管理代码,建议使用分支开发,不要直接在主分支上进行开发2.提交代码时必须编写有意义的提交信息,并按照规定的提交流程进行提交3.定期合并主分支的更新到自己的分支,保持代码的同步和整洁4.不要提交包含有敏感信息或测试用的临时代码的提交5.多人合作时,及时进行代码审核和讨论,确保代码质量和可维护性以上是一个WEB前端开发规范文档的示例。
web前端开发规范
web前端开发规范Web前端开发规范是指在前端开发过程中,对代码编写、命名、代码组织、样式书写、性能优化等方面进行规范化约束的一系列规则和标准。
遵循前端开发规范可以提高代码的可读性和可维护性,加快开发效率,并减少潜在的错误和bug。
一、HTML编写规范1. 使用语义化的标签,清晰地表示页面结构,并方便搜索引擎索引;2. 严格遵循HTML语法规范,使用闭合标签和正确的层次结构;3. 在标签属性中使用双引号,属性名使用小写字母,用中划线分隔,如:class="container";4. 避免使用行内样式,尽量使用外部CSS样式表。
二、CSS编写规范1. 选择器名使用小写字母,用中划线分隔,如:.container;2. 使用CSS预处理器编写CSS代码,如Sass或Less,提高代码的可复用性和维护性;3. 采用“模块化CSS”思想,将样式按模块分离,方便团队合作和代码管理;4. 避免使用通配符选择器和ID选择器,优先使用class选择器;5. 属性书写顺序一致性,可以使用“命名空间”的方式来分组属性,增加可读性;6. 避免使用浮动布局,尽量使用flexbox或grid布局。
三、JavaScript编写规范1. 代码缩进统一使用4个空格,并严格遵循语句块的花括号对齐规则;2. 函数和变量名使用驼峰命名法,类名首字母大写,常量全部大写;3. 使用严格模式("use strict")编写JavaScript代码,减少错误和不必要的行为;4. 避免使用全局变量,使用模块化或命名空间的方式避免命名冲突;5. 避免使用eval函数和with语句,减少安全风险;6. 使用ESLint等代码规范检查工具,保证代码质量和一致性。
四、性能优化规范1. 减少HTTP请求次数,合并并压缩CSS和JavaScript文件,并使用CDN加速;2. 使用图片懒加载和CSS Sprites技术,减少页面加载时间;3. 合理使用缓存,静态资源设置长期缓存,动态资源设置短期缓存;4. 减少DOM操作,使用事件委托和批量操作DOM;5. 在适当的位置添加异步加载脚本,提高页面加载速度;6. 使用CSS动画和过渡效果,而不是使用JavaScript实现动画效果。
前端开发规范文档
前端开发规范文档引言本文档旨在定义一套前端开发规范,规范涵盖了HTML、CSS和JavaScript的编码规范、文件组织规范以及注释规范等内容。
在项目中,所有前端开发人员必须遵守本文档中的规范,并且在开发过程中互相审查和纠正代码中的违规行为,确保项目的代码质量和可维护性。
一、HTML规范2.使用4个空格作为缩进,而不是制表符或者2个空格。
5.遵循嵌套顺序:结构、表现、行为。
二、CSS规范1.使用4个空格作为缩进,而不是制表符或者2个空格。
2.使用有意义的类名和ID,避免使用无意义的名称。
3.使用层级结构书写选择器,不要过分依赖后代选择器。
4. 使用-来连接多个单词的类名,例如.nav-bar。
5.避免嵌套选择器的层级过多,不超过3层。
6.选择器和属性之间使用空格隔开。
7.属性值为0时不需要单位。
8. 使用!important应该极少使用,并在必要的情况下给出充分的解释。
三、JavaScript规范1.使用4个空格作为缩进,而不是制表符或者2个空格。
2.使用驼峰命名法命名变量、函数和对象。
3. 使用let或const来声明变量,避免使用var。
4.在比较操作符中使用严格相等===和!==。
5.使用模板字符串来拼接字符串。
6.缩写应该避免,命名要具有描述性。
7.避免使用全局变量,尽量将变量的作用域限制在需要的范围内。
四、文件组织规范1. 将不同的文件放在不同的目录下,例如:css/、js/、img/。
2.使用有意义的文件名,避免使用无意义的名称。
3.遵循模块化的原则,将功能相关的代码组织到一个模块中。
4.使用版本控制系统来管理代码的版本和变更。
五、注释规范1.在代码的重要部分和复杂部分添加注释,解释代码的用途和实现方式。
2.使用单行注释//来注释一行代码,使用多行注释/**/来注释多行代码。
3.注释应该与代码对齐,并且清晰明了。
4.注释的语言要简洁明了,不要废话。
结语本文档规范了前端开发的一系列规则和标准,旨在提高团队的协作效率和项目的代码质量。
- 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。
最近开始着手网站的改版,因为是团队协作,所有需要注意很多地方,也为了让我们的代码更加规范特收集了一些Web前端开发规范规范目的为提高团队协作效率, 便于后台人员添加功能及前端后期优化维护, 输出高质量的文档, 特制订此文档. 本规范文档一经确认, 前端开发人员必须按本文档规范进行前台页面开发. 本文档如有不对或者不合适的地方请及时提出, 经讨论决定后方可更改.基本准则符合web标准, 语义化html, 结构表现行为分离, 兼容性优良. 页面性能方面, 代码要求简洁明了有序, 尽可能的减小服务器负载, 保证最快的解析速度.文件规范1. html, css, js, images文件均归档至<系统开发规范>约定的目录中;2. html文件命名: 英文命名, 后缀.htm. 同时将对应界面稿放于同目录中, 若界面稿命名为中文, 请重命名与html文件同名, 以方便后端添加功能时查找对应页面;3. css文件命名: 英文命名, 后缀.css. 共用base.css, 首页index.css, 其他页面依实际模块需求命名.;4. Js文件命名: 英文命名, 后缀.js. 共用common.js, 其他依实际模块需求命名.html书写规范1. 文档类型声明及编码: 统一为html5声明类型<!DOCTYPE html>; 编码统一为<meta charset="gbk" />, 书写时利用IDE实现层次分明的缩进;2. 非特殊情况下样式文件必须外链至<head>...</head>之间;非特殊情况下JavaScript文件必须外链至页面底部;3. 引入样式文件或JavaScript文件时, 须略去默认类型声明, 写法如下:<link rel="stylesheet" href="..." /><style>...</style><script src="..."></script>4. 引入JS库文件, 文件名须包含库名称及版本号及是否为压缩版, 比如jquery-1.4.1.min.js; 引入插件, 文件名格式为库名称+插件名称, 比如jQuery.cookie.js;5. 所有编码均遵循xhtml标准, 标签 & 属性 & 属性命名必须由小写字母及下划线数字组成, 且所有标签必须闭合, 包括 br (<br />), hr(<hr />)等; 属性值必须用双引号包括;6. 充分利用无兼容性问题的html自身标签, 比如span, em, strong, optgroup, label,等等; 需要为 html元素添加自定义属性的时候, 首先要考虑下有没有默认的已有的合适标签去设置, 如果没有, 可以使用须以"data-"为前缀来添加自定义属性,避免使用"data:"等其他命名方式;7. 语义化html, 如标题根据重要性用h*(同一页面只能有一个h1), 段落标记用p, 列表用ul, 内联元素中不可嵌套块级元素;8. 尽可能减少div嵌套, 如<div class="box"><div class="welcome">欢迎访问XXX, 您的用户名是<div class="name">用户名</div></div></div>完全可以用以下代码替代: <div class="box"><p>欢迎访问XXX, 您的用户名是<span>用户名</span></p></div>;9. 书写链接地址时, 必须避免重定向,例如:href="/", 即须在URL地址后面加上“/”;10. 在页面中尽量避免使用style属性,即style="…";11. 必须为含有描述性表单元素(input, textarea)添加label, 如<p> 姓名: <input type="text" id="name" name="name" /></p>须写成:<p><label for="name">姓名: </label><input type="text" id="name" /></p>12. 能以背景形式呈现的图片, 尽量写入css样式中;13. 重要图片必须加上alt属性; 给重要的元素和截断的元素加上title;14. 给区块代码及重要功能(比如循环)加上注释, 方便后台添加功能;15. 特殊符号使用: 尽可能使用代码替代: 比如 <(<) & >(>) & 空格( ) & »(»)等等;16. 书写页面过程中, 请考虑向后扩展性;17. class & id 参见 css书写规范.css书写规范1. 编码统一为utf-8;2. 协作开发及分工: i会根据各个模块, 同时根据页面相似程序, 事先写好大体框架文件, 分配给前端人员实现内部结构&表现&行为; 共用css文件base.css由i书写, 协作开发过程中, 每个页面请务必都要引入, 此文件包含reset及头部底部样式, 此文件不可随意修改;3. class与id的使用: id是唯一的并是父级的, class是可以重复的并是子级的, 所以id仅使用在大的模块上, class可用在重复使用率高及子级中; id 原则上都是由我分发框架文件时命名的, 为JavaScript预留钩子的除外;4. 为JavaScript预留钩子的命名, 请以 js_ 起始, 比如: js_hide, js_show;5. class与id命名: 大的框架命名比如header/footer/wrapper/left/right 之类的在2中由i统一命名.其他样式名称由小写英文 & 数字 & _ 来组合命名, 如i_comment, fontred, width200; 避免使用中文拼音, 尽量使用简易的单词组合; 总之, 命名要语义化, 简明化.6. 规避class与id命名(此条重要, 若有不明白请及时与i沟通):a, 通过从属写法规避, 示例见d;b, 取父级元素id/class命名部分命名, 示例见d;c, 重复使用率高的命名, 请以自己代号加下划线起始, 比如i_clear;d, a,b两条, 适用于在2中已建好框架的页面, 如, 要在2中已建好框架的页面代码<div id="mainnav"></div>中加入新的div元素,按a命名法则: <div id="mainnav"><div class="firstnav">...</div></div>,样式写法: #mainnav .firstnav{.......}按b命名法则: <div id="mainnav"><div class="main_firstnav">...</div></div>,样式写法: .main_firstnav{.......}7. css属性书写顺序, 建议遵循: 布局定位属性-->自身属性-->文本属性-->其他属性. 此条可根据自身习惯书写, 但尽量保证同类属性写在一起. 属性列举: 布局定位属性主要包括: display & list-style & position(相应的 top,right,bottom,left)& float & clear & visibility & overflow ;自身属性主要包括: width & height & margin & padding & border & background;文本属性主要包括:color & font & text-decoration & text-align & vertical-align & white- space & 其他 & content;我所列出的这些属性只是最常用到的, 并不代表全部;8. 书写代码前, 考虑并提高样式重复使用率;9. 充分利用html自身属性及样式继承原理减少代码量, 比如:<ul class="list"><li>这儿是标题列表<span>2010-09- 15</span></ul>定义ul.list li{position:relative} ul.list li span{position:absolute; rig ht:0}即可实现日期居右显示10. 样式表中中文字体名, 请务必转码成unicode码, 以避免编码错误时乱码;11. 背景图片请尽可能使用sprite技术, 减小http请求, 考虑到多人协作开发, sprite按模块制作;12. 使用table标签时(尽量避免使用table标签), 请不要用width/ height/cellspacing/cellpadding等table属性直接定义表现, 应尽可能的利用table自身私有属性分离结构与表现 , 如thead,tr,th,td,tbody,tfoot,colgroup,scope; (cellspaing及cellpadding 的css控制方法:table{border:0;margin:0;border-collapse:collapse;} table th, table td {padding:0;} , base.css文件中我会初始化表格样式)13. 杜绝使用<meta http-equiv="X-UA-Compatible" content="IE=7" />兼容ie8;14. 用png图片做图片时, 要求图片格式为png-8格式,若png-8实在影响图片质量或其中有半透明效果, 请为ie6单独定义背景:_background:none;_filter:progid:DXImageTransform.Microsoft.AlphaImage Loader (sizingMethod=crop, src=’img/bg.png’);15. 避免兼容性属性的使用, 比如text-shadow || css3的相关属性;16. 减少使用影响性能的属性, 比如position:absolute || float ;17. 必须为大区块样式添加注释, 小区块适量注释;18. 代码缩进与格式: 建议单行书写, 可根据自身习惯, 后期优化i会统一处理;JavaScript书写规范1. 文件编码统一为utf-8, 书写过程过, 每行代码结束必须有分号; 原则上所有功能均根据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注释, 单行注释使用'//这儿是单行注释' ,多行注释使用 /* 这儿有多行注释 */;开发及测试工具约定建议使用Aptana || Dw || Vim , 亦可根据自己喜好选择, 但须遵循如下原则:1. 不可利用IDE的视图模式'画'代码;2. 不可利用IDE生成相关功能代码, 比如Dw内置的一些功能js;3. 编码必须格式化, 比如缩进;测试工具: 前期开发仅测试FireFox & IE6 & IE7 & IE8 , 后期优化时加入Opera & Chrome & Safari;建议测试顺序: FireFox-->IE7-->IE8-->IE6-->Opera-->Chrome-->Safari, 建议安装firebug及IE Tab Plus插件.其他规范1. 开发过程中严格按分工完成页面, 以提高css复用率, 避免重复开发;2. 减小沉冗代码, 书写所有人都可以看的懂的代码. 简洁易懂是一种美德. 为用户着想, 为服务器着想.。