Web前端开发规范手册
软件开发Web前端开发规范
软件开发Web前端开发规范软件开发Web前端开发规范是指在进行Web前端开发过程中,为了统一团队的代码风格,提高代码的可读性、可维护性和可扩展性而制定的规范。
本文将从代码结构、命名规范、注释规范、HTML规范、CSS规范、JavaScript规范以及版本控制等几个方面,详细阐述Web前端开发规范的内容。
一、代码结构规范:1. 项目根目录下应包含必要的文件,如index.html、package.json 等;2. 将不同类型的文件(如HTML、CSS、JavaScript)分别放在不同的文件夹中,方便管理;3.对于大型项目,可以按照模块对文件进行进一步的组织。
二、命名规范:1. 变量、函数名使用驼峰命名法,如helloWorld;2. 类名使用帕斯卡命名法,如HelloWorld;3.常量名使用全大写字母,如PI;4. 文件名使用小写字母,多个单词使用下划线连接,如index.html。
三、注释规范:1.对于重要的函数、类、模块等,应添加详细的注释说明;2.使用单行注释(//)或多行注释(/**/)来注释代码,注释应描述清楚代码的功能和作用;3.注释应写在代码的上方或右侧,避免在代码行尾添加注释。
四、HTML规范:2.缩进使用两个空格,不使用制表符;4. 使用双引号包裹属性值,如class="container";5.避免使用行内样式,将样式写入CSS文件中。
五、CSS规范:1.代码缩进使用两个空格,不使用制表符;2. 使用中划线连接多个单词,如table-layout;3.选择器命名简洁明了,避免使用过长、复杂的名称;4.属性书写顺序应统一,比如先写布局相关的属性,再写样式相关的属性;5.使用CSS预处理器,如LESS、SASS等,提高开发效率。
六、JavaScript规范:1.使用ES6语法,提高代码的可读性和可维护性;2. 变量声明使用let或const,避免使用var;3.函数命名简洁明了,避免使用过长、复杂的名称;4.将多次使用的代码封装成函数,提高代码的复用性;5.避免使用全局变量和全局函数,减少命名冲突的可能性。
Web前端开发规范手册
Web前端开发规范手册修订历史记录日期版本说明作者2012年12月31日 1.0初稿施昀2012年01月05日 1.1施昀、戴静2012年01月07日 1.2施昀目录修订历史记录 (1)一、规范目的 (2)1.1概述 (2)二、基本准则 (2)三、文件规范 (3)2.1文件命名规则 (3)2.1.1HTML的命名原则 (3)2.1.2图片的命名原则 (3)2.1.3.javascript的命名原则 (4)2.1.4动态语言文件命名原则 (4)2.2文件存放位置规范 (4)2.3CSS书写规范 (4)2.3.1基本原则 (4)2.3.2注意细则 (5)2.3.3命名规则 (6)2.4html书写规范 (9)2.4.1head区代码规范 (9)2.4.2body区代码规范 (10)2.5JavaScript书写规范 (10)2.6图片规范 (10)2.7注释规范 (11)2.7.1html注释 (11)2.7.2css注释 (11)2.7.3JavaScript注释 (11)四、执行模式 (12)一、规范目的1.1概述提高团队协作效率便于前端开发以及后期优化维护方便新进的成员快速上手输出高质量的代码本规范文档一经确认,前端开发人员必须按本文档规范进行前台页面开发。
本文档如有不对或者不合适的地方请及时提出,经讨论决定后可以更新此文档。
二、基本准则符合web标准,语义化html,结构表现行为分离,兼容性优良。
代码要求简洁明了有序,尽可能的减小服务器负载,保证最快的解析速度。
开发时需要遵循如上基本准则,特殊情况可以有所宽限,如一些老项目的页面改造。
三、文件规范2.1文件命名规则[使用场景:在新建网页、图片、脚本、CSS文件时,根据此规则给文件命名并放入指定位置]文件名称统一用小写的英文字母、数字和下划线的组合,其中不得包含汉字空格和特殊字符。
命名原则的指导思想一是使得你自己和工作组的每一个成员能够方便的理解每一个文件的意义,二是当我们在文件夹中使用“按名称排例”的命令时,同一种大类的文件能够排列在一起,以便我们查找、修改、替换、计算负载量等等操作。
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.代码注释规范-使用注释来说明代码的用途和作用;-使用块注释来注释一整段代码,使用行注释来注释一行代码。
Web前端开发参考手册
Web前端开发参考手册WEB前端开发参考手册概况一(1.1 WEB 标准实现WEB标准二(2.1 XHTML、CSS介绍 2.2 XHTML书写规范2.2.1 XHTML结构2.2.2 标签规范2.3 XHTML常用标签介绍 2.4 CSS书写规范2.4.1 表命名参考2.4.2 类/ID命名规范2.4.3 样式调用2.4.4 样式简写2.5 CSS常用属性介绍2.6 图片规范2.7 注释规范2.8 浏览器兼容一(概况1.1 WEB 标准WEB 标准不是一个标准,而是一系列标准的集合。
网页主要由三部分组成:结构、表现和行为。
对应的标准也分三方面:结构化标准语言主要包括XHTML和XML,表现标准语言主要包括 CSS,行为标准主要包括对象模型(如 W3C DOM)、ECMAScript 等。
这些标准大部分由W3C起草和发布,也有一些是其他标准组织制订的标准,比如ECMA(European Computer ManufacturersAssociation)的 ECMAScript 标准。
二、实现WEB标准2.1 XHTML、CSS介绍可扩展超文本置标语言(eXtensible HyperText Markup Language,XHTML),是一种置标语言,表现方式与超文本置标语言(HTML)类似,不过语法上更加严格。
从继承关系上讲,HTML是一种基于标准通用置标语言(SGML)的应用,是一种非常灵活的置标语言,而XHTML则基于可扩展置标语言(XML),XML是SGML的一个子集。
XHTML 1.0在2000年1月26日成为W3C的推荐标准。
级联样式表(Cascading Style Sheet)简称“CSS”,通常又称为“风格样式表(Style Sheet)”,它是用来进行网页风格设计的。
比如,如果想让链接字未点击时是蓝色的,当鼠标移上去后字变成红色的且有下划线,这就是一种风格。
通过设立样式表,可以统一地控制HTML中各标志的显示属性。
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前端开发规范文档目录WEB前端开发规范文档 (1)规范目的 (2)基本准则 (2)文件规范 (2)html书写规范 (2)html其他规范 (3)css书写规范 (4)JavaScript书写规范 (5)jQuery部分 (5)开发及测试工具约定 (6)其他规范 (6)规范目的为提高团队协作效率, 便于后台人员添加功能及前端后期优化维护, 输出高质量的文档, 特制订此文档: 本规范文档一经确认, 前端开发人员必须按本文档规范进行前台页面开发: 本文档如有不对或者不合适的地方请及时提出, 经讨论决定后方可更改:基本准则1:符合web标准, 语义化html,遵循内容(HTML)、显示(CSS)、行为(JavaScript)分离的代码组织模式。
2:代码格式化,保持干净整洁。
3:换行必须缩进一个tab。
4:编写所有前台页面时,请使用已有模板进行复制,在模板的基础上进行开发。
5:每一个页面都必须有一个独立的css,js文件。
6:如果不是用HTML5编写的网站,请用IE7,IE8,IE9,火狐,谷歌,webkit,safari内核进行测试兼容性。
7:如果是HTML5编写的网站,请用IE9,火狐,谷歌,webkit,safari内核进行测试兼容性。
文件规范1: html, css, js, images文件均归档至<系统开发规范>约定的目录中;2: html文件命名: 英文命名, 后缀:htm: 同时将对应界面稿放于同目录中, 若界面稿命名为中文, 请重命名与html文件同名, 以方便后端添加功能时查找对应页面;3: css文件命名: 英文命名, 后缀:css: 共用base:css, 首页index:css, 其他页面依实际模块需求命名:;4: Js文件命名: 英文命名, 后缀:js: 共用common:js, 其他依实际模块需求命名:html书写规范1:所有元素都必须小写,属性也是,如: <input type=”text”id=”idName”/>正确<INPUT TYPE=”text”ID=”idName”/>错误2:元素必须成对出现,如<span>必须写成<span></span>特殊元素除外,如:<br /><hr /><img /><input />3:标签中不允许出现样式,必须用class来声明样式,如:<input type=”text”id=”idName”style=”text-align:right;”/>错误<input type=”text”id=”idName”class=”class-name”/>正确4:元素id命名必须是驼峰式命名如:<input type=”text”id=”idName”/>正确<input type=”text”id=”idname”/>错误<input type=”text”id=”id-name”/>错误5:元素class命名规范是:元素简写+”-”+功能名,如:<button calss=”btn-save”></button>正确<button calss=”btnSave”></button>错误<button calss=”save”></button>错误6:元素name命名必须遵循驼峰式命名法。
Web前端开发规范手册
Web前端开发规范手册一、规范目的1.1 概述 1二、文件规范2.1 文件命名规则 (1)2.2 文件存放位置22.3 css 书写规范32.4 html书写规范72.5 JavaScript书写规范112.6 图片规范122.7 注释规范132.8 css 浏览器兼容13一、规范目的1.1 概述为提高团队协作效率, 便于后台人员添加功能及前端后期优化维护, 输出高质量的文档, 特制订此文档. 本规范文档一经确认, 前端开发人员必须按本文档规范进行前台页面开发. 本文档如有不对或者不合适的地方请及时提出, 经讨论决定后可以更改此文档.二、文件规范2.1 文件命名规则文件名称统一用小写的英文字母、数字和下划线的组合,其中不得包含汉字、空格和特殊字符;命名原则的指导思想一是使得你自己和工作组的每一个成员能够方便的理解每一个文件的意义,二是当我们在文件夹中使用“按名称排例”的命令时,同一种大类的文件能够排列在一起,以便我们查找、修改、替换、计算负载量等等操作。
a. HTML的命名原则引文件统一使用index.htm index.html index.asp文件名(小写)各子页命名的原则首先应该以栏目名的英语翻译取单一单词为名称。
例如:关于我们\ aboutus信息反馈\ feedback产品\ product如果栏目名称多而复杂并不好以英文单词命名,则统一使用该栏目名称拼音或拼音的首字母表示;每一个目录中应该包含一个缺省的html 文件,文件名统一用index.htm index.html index.asp;b. 图片的命名原则图片的名称分为头尾两部分,用下划线隔开,头部分表示此图片的大类性质例如:广告、标志、菜单、按钮等等。
放置在页面顶部的广告、装饰图案等长方形的图片取名:banner标志性的图片取名为:logo在页面上位置不固定并且带有链接的小图片我们取名为button在页面上某一个位置连续出现,性质相同的链接栏目的图片我们取名:menu装饰用的照片我们取名:pic不带链接表示标题的图片我们取名:title范例: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"。
WEB前端开发规范
WEB前端开发规范WEB前端开发规范WEB前端开发规范目录1、规范目的2、基本准则3、文件规范4、文件规范5、html书写规范6、css书写规范7、JavaScript书写规范8、图片规范9、注释规范10、开发及测试工具约定11、其他规范12、CSSHack1规范目的为提高团队协作效率,便于后台人员添加功能及前端后期优化维护,输出高质量的文档,同是为网站有一个更好的前端架构,网站的发展及未来打好一个基础。
本文档如有不对或者不合适的地方请提出来,基本准则符合web标准,语义化html,结构表现行为分离,兼容性优良.页面性能方面,代码要求简洁明了有序,尽可能的减小服务器负载,保证最快的解析速度.文件规范3.1、html,css,js,images文件均归档至约定的目录中;23 3.2、html文件命名:命名以中文命名,依实际模块命名,如果同一模块以_&title&_来组合命名,以方便添加功能时查找对应页面,团结里的相互理解。
例如:我的好股网里的TAB命名大模块名称_小模块的titile.html我的好股网_关注的微博.html3.3、css文件命名:英文命名,后缀.css.初始化样式reset.css,其他样式依实际模块页面需求命名,共用样式一般以模块考虑来划分命名,如有改版修改的css文件可以采用&_时间日期例如:微博改版版块名称_时间日期.cssnew_blog_1212.css4.4、Js文件命名:英文命名,后缀.js.共用common.js,其他依实际模块需求命名.5.5、图片命名:4html书写规范4.1、文档类型声明及编码:统一用;编码统一为。
目的:统一性和网站提高开发合作效率。
4.2、非特殊情况下样式文件必须外链至之间;非特殊情况下JavaScript文件必须外链至页面底部之前;目的:网站的优化。
4.3、所有编码均遵循xhtml标准,标签&属性&属性命名必须由小写字母及下划线数字组成,且所有标签必须闭合,包括br(),hr()等;属性值必须用双引号包括;目的:更加符合web标准(w3c),也有利于seo。
WEB前端开发规范(可复制)
WEB前端开发规范目录一.实现符合W3C的Web 标准 (3)1.1软件环境 (3)1.1.1制作软件 (3)1.1.2 测试软件 (3)1.2 网站架构的流程 (3)1.2.1设计稿的分析 (3)1.2.2切图 (4)1.2.3 XHTML和CSS的编写 (4)1.3 XHTM代码编写规范 (5)1.3.01 统一DOCTYPE (5)1.3.02 统一指定语言及字符集 (5)1.3.04 所有的标签都必须使用结束标记 (6)1.3.05 所有标签和属性名称都必须小写 (6)1.3.06 属性值必须使用双引号括起来 (6)1.3.07 不允许使用属性简写 (6)1.3.08 所有标签都必须合理嵌套 (7)1.3.09 特殊符号都用编码表示 (7)1.3.10 图片标签必须要有ALT属性 (7)1.3.11 注视的规范写法 (7)1.3.12 尽可能用id属性代替name属性 (7)1.3.13 尽量使用语义标签。
(8)1.4CSS代码编写规范 (8)1.4.01 规范相关注释 (8)1.4.02 调用样式的方法统一 (9)1.4.02 选择符命名采用驼峰式命名法 (9)1.4.03 不使用行内样式和页内样式 (9)1.4.03 正确的选择CLASS和ID (9)1.4.04 使用RESET 将默认的CSS 重置 (10)1.4.05 分离CSS可复用部分 (10)1.4.06 适当实用CSS HACK (10)1.4.07 CSS语法、书写格式符合规范 (10)1.4.08 属性有序的排列 (10)1.4.09 样式表组织统一 (11)1.4.10 其它相应规范 (11)二、XHTML元素的命名参考 (12)2.1布局页面的div id命名 (12)2.2页面的各种元素id 命名和class命名 (12)2.3常用的命名关键字 (13)一. 实现符合W3C 的Web 标准1.1软件环境 1.1.1制作软件使用Dreamweaver 和 Frontpage 等直接视图进行网页制作。
WEB前端开发规范文档+CSS命名规范
WEB前端开发规范文档+CSS命名规范规范目的为提高团队协作效率, 便于后台人员添加功能及前端后期优化维护, 输出高质量的文档, 特制订此文须按本文档规范进行前台页面开发. 本文档如有不对或者不合档. 本规范文档一经确认, 前端开发人员必前端开发人员必适的地方请及时提出, 经讨论决定后方可更改.基本准则符合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文件时, 须略去默认类型声明, 写法如下:Example Source Code []<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,等等; 需要为htm首先 要考虑下有没有默认的已有的合适标签去设置, 如果没有, 可以使用须l元素添加自定义属性的时候, 首先以"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, 如Example Source Code []<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中已建好框架的页面, 如,Example Source Code []要在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 属性书写顺序, 建议遵循: 布局定位属性-->自身属性-->文本属性-->其他属性. 此条可根据自身习惯书写, 但尽量保证同类属但尽量保证同类属 性写在一起.Example Source Code []属性列举:布局定位属性主要包括: 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 自身属性及样式继承原理减少代码量, 比如:Example Source Code []<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 等t able 属性直接定义表现, 应尽可能的利用table 自身私有属性分离结构与表现 , 如Example Source Code []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单独定义背景:Example Source Code []_background:none;_filter:progid:DXImageTransform.Microsoft.AlphaImageLoader(sizingMethod=crop, (sizingMethod=crop, src=’img/bg.png’);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;Example Source Code []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. 减小沉冗代码, 书写所有人都可以看的懂的代码. 简洁易懂是一种美德. 为用户着想, 为服务器着想.DIV+CSS 命名规范1.CSS ID 的命名外 套:套: wrap主导航:主导航: mainnav子导航:子导航: subnav页 脚:脚: footet整个页面:整个页面: content页 眉:眉: header页 脚:脚: footer商 标:标: label标 题:题: title主导航:主导航: mainbav (globalnav )顶导航:顶导航: topnav边导航:边导航: sidebar左导航:左导航: leftsidebar右导航:右导航: rightsidebar旗 志:志: logo标 语:语: banner菜单内容1: menu1 content菜单容量:菜单容量: menu container子菜单:子菜单: submenu边导航图标:sidebarIcon注释:注释: note面包屑:面包屑: breadcrumb(即页面所处位置导航提示)即页面所处位置导航提示) 容器:容器: container内容:内容: content搜索:搜索: search登陆:登陆: Login功能区:功能区: shop(如购物车,收银台)当前的当前的 current2.另外在编辑样式表时可用的注释可这样写: <-- Footer -->内容区内容区<-- End Footer -->3.样式文件命名主要的主要的 master.css布局,版面布局,版面 layout.css专栏专栏 columns.css文字文字 font.css打印样式打印样式 print.css主题主题 themes.css。
文豆Web前端开发规范手册V1.2
文豆Web前端开发规范手册文豆WEB前端开发规范手册1、规范目的 (3)2、基本准则 (3)3、文件规范 (3)3.1目录结构 (3)3.2 HTML 文件命名 (3)3.3 CSS 文件命名 (3)3.4JS文件命名 (4)4、HTML 书写规范 (4)4.1编码 (4)4.2文档类型声明 (4)4.3语法 (4)4.4文件引入 (4)4.5语义化HTML (5)5、CSS 书写规范 (5)5.1编码 (5)5.2协作开发及分工 (6)5.3CSS语法 (6)5.4 CLASS 与ID 命名 (6)5.6属性列举 (6)5.7CSS优化 (7)6、JAVASCRIPT 书写规范 (7)6.1编码 (7)6.2语法 (7)6.3变量命名 (7)6.4变量声明 (7)7、注释规范 (8)7.1 HTML 注释 (8)7.2 CSS 注释 (8)7.3J AVA S CRIPT 注释 (8)8、图片规范 (8)9、开发测试工具约定 (8)1、规范目的为提高团队协作效率,便于后台开发人员套页面及前端后期优化维护,输出高质量的文档,特制订此文档。
本规范文档一经确认,前端开发人员必须按本文档规范进行前端页面制作。
本文档如有不对或者不合适的地方请及时提出,经讨论决定后方可更改。
2、基本准则编写符合w3c 标准,语义化的html,实现结构、表现、行为分离;浏览器兼容性优良(暂定IE、chrome、firefox)。
页面性能方面,代码要求简洁有序, 尽可能的减小服务器负载,注重css 代码质量,保证浏览器能最快的解析。
3、文件规范3.1 目录结构css、js、images文件均归档至约定的目录中。
约定目录为://index.html/images//css/base.css/js/common.jsjquery-1.9..min.js可根据需要创建子目进行分类。
3.2 html 文件命名英文命名,后缀为.html3.3 css 文件命名英文命名,后缀为.css。
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请求。
- 合理使用缓存,避免重复请求相同的数据。
入门资料:web前端开发规范
本文主要从以下几个方面来概述前端的开发规范1. 目录构建规范2. 前端命名规范3. 前端工作规范4. 开发文档的书写规范1. 前端目录构建规范我们从命名原则、根目录、业务逻辑等方面进行目录构建1.1 命名原则:- 简洁明了(如下:)* src 源代码* img 图片资源* js JavaScript脚本* dep 第三方依赖包- 不使用复数(如下:)* 不使用imgs docs1.2 根目录(root)结构按职能划分(如下:)- src 源代码(逻辑)- doc 文档- dep 第三方依赖包- test 测试1.3 根据业务逻辑进行文件夹的划分(如下:)- src目录名词解释:- common 公共资源- public/static 静态资源- component 组件- view/tpl 模板文件```srccommon 公共资源imglogo.pngsprites.pngcssreset.cssjsconf.js 项目的配置文件public/static 静态资源jscsstplindex.html shopcar.htmlimgcomponent 组件homeshopcarloginregisteruserlistdetailview/tpl 项目模板tpl 是template的缩写```1.4 总结:以上目录开发规范有两种使用途径1. 使用前端工程化工具如webpack、gulp等进行手动打造2. 利用框架提供的脚手架工具进行修改2. 前端命名规范这部分内容我从以下两个方面来进行讲解·CSS命名规范o BEM规范o OOCSS规范·javaScript编写规范o jslinto eslint2.1 css命名规范2.1.1 BEM规范- 概念:Block Element Modifier,它是一种前端命名方法,旨在帮助开发者实现模块化、可复用、高可维护性和结构化的CSS代码。
前端开发规范手册
前端开发规范手册前端开发规范手册一、命名规范1. 文件名使用小写字母,并且以连字符(-)连接。
2. 类型命名使用大驼峰命名法,例如:UserInfo。
3. 函数和变量使用小驼峰命名法,例如:getUserInfo。
4. CSS类名使用小写字母,并且以连字符(-)连接,例如:user-info。
二、代码规范1. 使用两个空格缩进代码。
2. 代码段之间加入空行,以提高可读性。
3. 对于较长的代码行,可以使用反斜杠(\)进行分行。
4. 尽量避免使用全局变量,使用局部变量和函数封装来避免变量冲突。
5. 删除不必要的空格、空行和注释。
三、HTML规范1. 缩进使用两个空格。
2. 使用语义化标签,例如:header、nav、section、article、aside等。
3. 尽量避免使用行内样式,使用外部CSS文件来处理样式。
4. 使用双引号来引用属性值。
四、CSS规范1. 使用CSS预处理器,例如:Sass或Less,来提高代码复用性和可维护性。
2. 使用规范的命名方式来命名CSS类名。
3. 使用缩写属性来减少代码量,例如:margin、padding、border等。
4. 使用CSS代码压缩工具来减少文件大小。
五、JavaScript规范1. 使用严格模式,使用"use strict"指令。
2. 避免使用全局变量,使用模块化的方式来封装代码。
3. 使用ES6的新特性来提高代码质量和可读性,例如:箭头函数、解构赋值、模板字符串等。
4. 避免使用eval函数,尽量使用其他方法来解决问题。
5. 使用事件委托方式来处理事件,减少事件监听器的数量。
六、图片规范1. 使用合适的图片格式,例如:JPEG、PNG、GIF等。
2. 压缩图片文件大小,使用压缩工具来减小文件大小。
3. 使用CSS Sprite技术来减少HTTP请求次数。
4. 使用图片懒加载技术来提高页面加载速度。
七、性能规范1. 删除不必要的代码和文件,减少HTTP请求次数。
web前端规范,js规范
WEB前端开发规范1. 基本原则* 遵循内容(HTML)、显示(CSS)、行为(JavaScript)分离的代码组织模式* 代码格式化,保持干净整洁2. HTML部分2.1. 添加必须的utf-8的字符集,并且使用HTML5的简洁方式:<meta charset="utf-8" />2.2. 遵循xhtml 1.0规则:1) 所有标签必须结束2) 所有标签必须小写3) 标签属性必须使用成对引号(单引号或双引号)4) 标签属性必须有值:<select><option selected="selected"></option></select><input type="checkbox" checked="checked" />5) 所有特殊符号必须转义(&、<、>、?、?…)2.3. 标签属性命名规范id:连接符命名法“hello-world”class: 连接符命名法“hello-world”name:骆驼式命名法“helloWorld”1) 表单元素的id必须加以下前缀label: lbltext: txtpassword: txttextarea: txtfile: txtradio: radcheckbox: chksubmit: btnreset: btnbutton: btnhidden: hid2) 用于结构布局的元素id命名主容器: main页头: header页脚: footer内容区域: contentLOGO: logo主导航: main-nav二级导航: sub-nav3) name命名一般用于表单元素,根据当前元素id属性值命名,去掉id属性值的前缀和所有连接符,使用骆骆式命名法命名,例如id=”txt-id-card”,那么name=”idCard”。
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前端开发设计规范Web前端开发是指将网站或者Web应用程序的用户界面设计和开发成一系列可以在浏览器中运行的页面和交互功能。
在开发过程中,遵循一定的设计规范是非常重要的,可以保证代码的可读性、可维护性,提高团队协作效率。
下面是一些Web前端开发设计规范的建议。
1. 文件结构和命名规范(1) 在项目中,应该建立一个统一的文件结构,包括css文件夹用于存放样式文件、js文件夹用于存放脚本文件、images文件夹用于存放图片等。
(2) 文件和文件夹的命名应该具备可读性和表达性,避免使用拼音或者缩写,使用驼峰命名法,如:main.css。
(3) 对于图片文件,最好使用有意义的命名,以便于后期维护。
例如,banner.jpg表示网站首页的横幅图片。
2. 代码编写规范(1) 使用恰当的缩进和空格,使代码具有良好的可读性。
一般来说,使用2或4个空格作为一个缩进单位。
(2) 使用有意义的变量和函数名,避免使用单个字符或者无意义的命名。
变量和函数名应该具有描述性,一眼就能看出其作用。
(3) 在代码中添加必要的注释,解释代码的用途、实现逻辑等。
注释应该简洁明了,不要写过多无关的内容。
(4) 遵循DRY原则(Don't Repeat Yourself),避免重复的代码。
可以使用函数或者类来封装重复的代码,提高代码的复用性。
(5) 尽量避免使用全局变量,避免命名冲突。
如果需要使用全局变量,可以使用命名空间来避免冲突。
3. 样式规范(1) 使用外部CSS文件,将CSS样式与HTML页面分离开来,提高可维护性。
(2) 遵循命名规范,使用有意义的类名和ID名。
类名和ID名应该描述元素的用途或者特性,避免使用无意义或者过于复杂的名称。
(3) 避免使用行内样式,除非必要。
行内样式会增加HTML页面的复杂性,不利于维护。
(4) 使用合适的选择器,避免使用通用选择器和后代选择器,以提高样式的选择性和效率。
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实现动画效果。
web前端开发规范
Web前端开发规范手册一、规范目的1。
1 概述。
.....。
.。
.。
..。
.....。
.。
.。
.。
.。
.。
.。
.。
..。
.。
..。
.。
...。
.。
....。
.。
..。
.。
...。
..。
.。
..。
.。
.。
...。
.。
.。
..。
...。
.。
..。
..。
.。
1二、文件规范2。
1 文件命名规则。
.。
......。
.。
..。
.。
.。
.。
..。
.。
..。
.。
.。
..。
..。
.。
.。
..。
..。
.....。
.。
....。
.。
.。
.。
.。
.。
..。
..。
.。
.。
..。
.。
.。
.12。
2 文件存放位置..。
...。
....。
..。
.。
.。
..。
..。
.。
......。
.。
.。
.。
...。
....。
.。
..。
.。
.。
...。
.。
.。
..。
.。
.。
..。
.。
.。
.。
..。
..。
22。
3 html 书写规范..。
...。
.。
..。
.。
.。
.。
.。
..。
.。
.。
....。
.。
..。
.。
.。
.。
..。
..。
.。
.。
.。
.。
.。
..。
.。
....。
.。
...。
..。
..。
.。
.。
.。
..。
.。
22。
4 css 书写规范。
.。
......。
.。
.。
..。
.。
..。
..。
.。
....。
.。
.....。
.....。
.。
...。
...。
..。
.。
...。
..。
..。
.。
.。
.。
.。
.......。
72.5 JavaScript 书写规范。
.。
..。
.。
.。
.....。
......。
....。
..。
...。
..。
.。
.。
.。
.。
....。
..。
.。
...。
..。
.。
..。
.....。
.。
.。
.。
.。
.。
122.6 图片规范。
.....。
..。
...。
.。
.。
...。
.。
.....。
...。
.。
.。
.。
.。
...。
.。
....。
.。
.。
.。
...。
...。
.。
.。
.。
...。
....。
...。
......。
192。
7 注释规范。
.........。
..。
.。
..。
..。
..。
..。
.。
.。
..。
..。
.。
.。
.。
...。
.。
- 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。
Web前端开发规范手册一、规范目的1.1 概述 (1)二、文件规范2.1 文件命名规则 (1)2.2 文件存放位置 (2)2.3 css 书写规范 (3)2.4 html书写规范 (7)2.5 JavaScript书写规范 (11)2.6 图片规范 (12)2.7 注释规范 (13)2.8 css 浏览器兼容 (13)一、规范目的1.1 概述为提高团队协作效率, 便于后台人员添加功能及前端后期优化维护, 输出高质量的文档, 特制订此文档. 本规范文档一经确认, 前端开发人员必须按本文档规范进行前台页面开发. 本文档如有不对或者不合适的地方请及时提出, 经讨论决定后可以更改此文档.二、文件规范2.1 文件命名规则文件名称统一用小写的英文字母、数字和下划线的组合,其中不得包含汉字、空格和特殊字符;命名原则的指导思想一是使得你自己和工作组的每一个成员能够方便的理解每一个文件的意义,二是当我们在文件夹中使用“按名称排例”的命令时,同一种大类的文件能够排列在一起,以便我们查找、修改、替换、计算负载量等等操作。
a. HTML的命名原则引文件统一使用index.htm index.html index.asp文件名(小写)各子页命名的原则首先应该以栏目名的英语翻译取单一单词为名称。
例如:关于我们\ aboutus信息反馈\ feedback产品\ product如果栏目名称多而复杂并不好以英文单词命名,则统一使用该栏目名称拼音或拼音的首字母表示;每一个目录中应该包含一个缺省的html 文件,文件名统一用index.htm index.html index.asp;b. 图片的命名原则图片的名称分为头尾两部分,用下划线隔开,头部分表示此图片的大类性质例如:广告、标志、菜单、按钮等等。
放置在页面顶部的广告、装饰图案等长方形的图片取名:banner标志性的图片取名为:logo在页面上位置不固定并且带有链接的小图片我们取名为button在页面上某一个位置连续出现,性质相同的链接栏目的图片我们取名:menu装饰用的照片我们取名:pic不带链接表示标题的图片我们取名:title范例: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.gifc. javascript的命名原则例如:广告条的javascript文件名为ad.js 弹出窗口的javascript文件名为pop.jsd. 动态语言文件命名原则以性质_描述,描述可以有多个单词,用“_”隔开,性质一般是该页面得概要。
范例:register_form.asp register_post.asp topic_lock.asp2.2 文件存放位置规范_Rootcn 存放中文HTML文件en 存放英文HTML文件flash 存放Flash文件images 存放图片文件imagestudio 存放PSD源文件flashstudio 存放flash源文件inc 存放include文件library 存放DW库文件media 存放多媒体文件project 存放工程项目资料temp 存放客户原始资料js 存放JavaScript脚本css 存放CSS文件2.3 CSS 书写规范基本原则: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">注意细则:1. 协作开发及分工: i会根据各个模块, 同时根据页面相似程序, 事先写好大体框架文件, 分配给前端人员实现内部结构&表现&行为; 共用css文件base.css由i书写, 协作开发过程中, 每个页面请务必都要引入, 此文件包含reset及头部底部样式, 此文件不可随意修改;2. class与id的使用: id是唯一的并是父级的, class是可以重复的并是子级的, 所以id仅使用在大的模块上, class可用在重复使用率高及子级中; id原则上都是由我分发框架文件时命名的, 为JavaScript预留钩子的除外;3. 为JavaScript预留钩子的命名, 请以js_ 起始, 比如: js_hide, js_show;4. class与id命名: 大的框架命名比如header/footer/wrapper/left/right之类的在2中由i统一命名.其他样式名称由小写英文& 数字& _ 来组合命名, 如i_comment, fontred, width200; 避免使用中文拼音, 尽量使用简易的单词组合; 总之, 命名要语义化, 简明化.5. 规避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{.......}6. 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等.我所列出的这些属性只是最常用到的, 并不代表全部;7. 书写代码前, 考虑并提高样式重复使用率;8. 充分利用html自身属性及样式继承原理减少代码量, 比如:<ul class="list"><li>这儿是标题列表<span>2010-09-15</span></ul>定义ul.list li{position:relative} ul.list li span{position:absolute; right:0}即可实现日期居右显示9. 样式表中中文字体名, 请务必转码成unicode码, 以避免编码错误时乱码;10. 背景图片请尽可能使用sprite技术, 减小http请求, 考虑到多人协作开发, sprite按模块制作;11. 使用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文件中我会初始化表格样式)12. 杜绝使用<meta http-equiv="X-UA-Compatible" content="IE=7" /> 兼容ie8;13. 用png图片做图片时, 要求图片格式为png-8格式,若png-8实在影响图片质量或其中有半透明效果, 请为ie6单独定义背景:background:none;_filter:progid:DXImageTransform.Microsoft.AlphaImageLoader(sizingMethod= crop, src=’img/bg.png’);14. 避免兼容性属性的使用, 比如text-shadow || css3的相关属性;15. 减少使用影响性能的属性, 比如position:absolute || float ;16. 必须为大区块样式添加注释, 小区块适量注释;17. 代码缩进与格式: 建议单行书写, 可根据自身习惯, 后期优化i会统一处理;类命名规则:头:header内容:content/container尾:footer导航:nav侧栏:sidebar栏目:column页面外围控制整体布局宽度:wrapper左右中:left right center登录条:loginbar标志:logo广告:banner页面主体:main热点:hot新闻:news下载:download子导航:subnav菜单:menu子菜单:submenu搜索:search友情链接:friendlink页脚:footer版权:copyright滚动:scroll内容:content标签页:tab文章列表:list提示信息:msg小技巧:tips栏目标题:title指南:guild服务:service注册:regsiter状态:status投票:vote合作伙伴:partner(二)注释的写法:/* Footer */内容区/* End Footer */(三)id的命名:(1)页面结构容器: container页头:header内容:content/container页面主体:main页尾:footer导航:nav侧栏:sidebar栏目:column页面外围控制整体布局宽度:wrapper 左右中:left right center(2)导航导航:nav主导航:mainbav子导航:subnav顶导航:topnav边导航:sidebar左导航:leftsidebar右导航:rightsidebar菜单:menu子菜单:submenu标题: title摘要: summary(3)功能标志:logo广告:banner登陆:login登录条:loginbar注册:regsiter搜索:search标题:title加入:joinus状态:status按钮:btn滚动:scroll标签页:tab文章列表:list提示信息:msg当前的: current小技巧:tips图标: icon注释:note指南:guild服务:service热点:hot新闻:news下载:download投票:vote合作伙伴:partner友情链接:link版权:copyright\基本样式:/* CSS Document */body {margin:0; padding:0; font:12px "\5B8B\4F53",san-serif;background:#fff;}div,dl,dt,dd,ul,ol,li,h1,h2,h3,h4,h5,h6,pre,form,fieldset,input,textarea,blockquote,p{padding:0; margin:0;}table,td,tr,th{font-size:12px;}li{list-style-type:none;}img{vertical-align:top;border:0;}ol,ul {list-style:none;}h1,h2,h3,h4,h5,h6 {font-size:12px; font-weight:normal;}address,cite,code,em,th {font-weight:normal; font-style:normal;}.fB{font-weight:bold;}.f12px{font-size:12px;}.f14px{font-size:14px;}.left{float:left;}.right{float:right;}a {color:#2b2b2b; text-decoration:none;}a:visited {text-decoration:none;}a:hover {color:#ba2636;text-decoration:underline;}a:active {color:#ba2636;}重定义的最先,伪类其次,自定义最后,便于自己和他人阅读!不同浏览器上字号保持一致,字号建议用点数pt和像素px来定义,pt一般使用中文宋体的9pt 和11pt,px一般使用中文宋体12px 和14.7px 这是经过优化的字号,黑体字或者宋体字加粗时,一般选用11pt 和14.7px 的字号比较合适。