Web前端开发标准手册.docx

1、Web前端开发标准手册Web前端开发标准手册一、标准目的 概述 . 1二、文件标准 文件命名规那么.1 文件寄存位置.2 css 书写标准.3 html书写标准.7 JavaScript书写标准.11 图片标准.12 注释标准.13 css 浏览器兼容.13一、标准目的 概述为提高团队协作效率, 便于后台人员添加功能及前端后期优化保护, 输出高质量的文档, 特制订此文档. 本标准文档一经确认, 前端开发人员必需按本文档标准进行前台页面开发. 本文档如有不对或不适合的地址请及时提出, 经讨论决定后能够更改此文档.二、文件标准 文件命名规那么 文件名称统一用小写的英文字母、数字和下划线的组合，其中

2、不得包括汉字、空格和特殊字符；命名原那么的指导思想一是使得你自己和工作组的每一个成员能够方便的明白得每一个文件的意义，二是当咱们在文件夹中利用“按名称排例”的命令时，同一种大类的文件能够排列在一路，以便咱们查找、修改、替换、计算负载量等等操作。a. HTML的命名原那么引文件统一使用 文件名（小写）各子页命名的原那么第一应该以栏目名的英语翻译取单一单词为名称。例如： 关于咱们 aboutus 信息反馈 feedback 产 品 product若是栏目名称多而复杂并非好以英文单词命名，那么统一利用该栏目名称拼音或拼音的首字母表示；每一个目录中应该包括一个缺省的html 文件，文件名统一用 ；b.

3、 图片的命名原则图片的名称分为头尾两部份，用下划线隔开，头部份表示此图片的大类性质例如：广告、标志、菜单、按钮等等。放置在页面顶部的广告、装饰图案等长方形的图片取名： banner标志性的图片取名为： logo在页面上位置不固定而且带有链接的小图片咱们取名为 button 在页面上某一个位置持续显现，性质相同的链接栏目的图片咱们取名： menu 装饰用的照片咱们取名： pic不带链接表示题目的图片咱们取名： title 范例： 鼠标感应成效图片命名标准为图片名+_+on/off。例如： c. javascript的命名原那么例如：广告条的javascript文件名为 弹出窗口的javascri

4、pt文件名为 d. 动态语言文件命名原那么以性质_描述，描述能够有多个单词，用“_”隔开，性质一样是该页面得概要。范例： 文件寄存位置标准_Rootcn存放中文HTML文件en存放英文HTML文件flash存放Flash文件images存放图片文件imagestudio存放PSD源文件flashstudio存放flash源文件inc存放include文件library存放DW库文件media存放多媒体文件project存放工程项目资料temp存放客户原始资料js存放JavaScript脚本css存放CSS文件 CSS 书写标准大体原那么：CSS样式可细分为3类：自概念样式、从头概念HTML样式

5、、链接状态样式。1. 样式为设计师自概念的新 CSS 样式，阻碍被利用本样式的区域，用于完成网页中局部的样式设定。样式名 “.”+“相应样式成效描述的单词或缩写”例：“ .shadow ”文字样式样式名“.no”+“字号”+“行距”+“颜色缩写”例：“ .no12 ” 、“ .no12-24 ”2. 义HTML样式为设计师从头概念已有的HTML标签样式，阻碍全数的被设定标签样式，用于统一网页中某一标签的样式概念。样式名“HTML标签”例：hr border: 1px dotted #333333 3. 态样式为设计师对链接不同状态设定特殊样式，阻碍被利用本样式区域中的链接。该样式写法有2种：

6、:link :link 第一种只能修饰标签中；第二种能够修饰所有包括有标签的其他标签。页面内的样式加载必需用链接方式注意细那么：1. 协作开发及分工: i会根据各个模块, 同时根据页面相似程序, 事先写好大体框架文件, 分配给前端人员实现内部结构&表现&行为; 共用css文件由i书写, 协作开发过程中, 每个页面请务必都要引入, 此文件包含reset及头部底部样式, 此文件不可随意修改;2. class与id的使用: id是唯一的并是父级的, class是可以重复的并是子级的, 所以id仅使用在大的模块上, class可用在重复使用率高及子级中; id原则上都是由我分发框架文件时命名的, 为J

7、avaScript预留钩子的除外;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, 取父

8、级元素id/class命名部份命名, 例如见d; c, 重复利用率高的命名, 请以自己代号加下划线起始, 比如i_clear; d, a,b两条, 适用于在2中已建好框架的页面, 如, 要在2中已建好框架的页面代码中加入新的div元素,按a命名法那么: ., 样式写法: #mainnav .firstnav.按b命名法那么: ., 样式写法: .main_firstnav.6. css属性书写顺序, 建议遵循 布局定位属性-自身属性-文本属性-其他属性. 此条可根据自身习惯书写, 但尽量保证同类属性写在一起. 属性列举: 布局定位属性主要包括: margin、padding、float（包括c

9、lear）、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.

10、充分利用html自身属性及样式继承原理减少代码量, 比如:这儿是题目列表2020-09-15概念 liposition:relative li spanposition:absolute; right:0即可实现日期居右显示9. 样式表中中文字体名, 请务必转码成unicode码, 以避免编码错误时乱码;10. 背景图片请尽可能使用sprite技术, 减小http请求, 考虑到多人协作开发, sprite按模块制作;11. 使用table标签时(尽量避免使用table标签), 请不要用width/ height/cellspacing/cellpadding等table属性直接定义表现, 应尽

11、可能的利用table自身私有属性分离结构与表现, 如thead,tr,th,td,tbody,tfoot,colgroup,scope; (cellspaing及cellpadding的css控制方法: tableborder:0;margin:0;border-collapse:collapse; table th, table tdpadding:0; , 文件中我会初始化表格样式)12. 杜绝使用 兼容ie8;13. 用png图片做图片时, 要求图片格式为png-8格式,若png-8实在影响图片质量或其中有半透明效果, 请为ie6单独定义背景:background:none;_filte

12、r:progid: src=img/);14. 避免兼容性属性的使用, 比如text-shadow | css3的相关属性;15. 减少使用影响性能的属性, 比如position:absolute | float ;16. 必须为大区块样式添加注释, 小区块适量注释;17. 代码缩进与格式: 建议单行书写, 可根据自身习惯, 后期优化i会统一处理;命名规那么：头：header 内容：content/container 尾：footer 导航：nav 侧栏：sidebar 栏目：column 页面外围操纵整体布局宽度：wrapper 左右中：left right center 登录条：login

13、bar 标志：logo 广告：banner 页面主体：main 热点：hot 新闻：news 下载：download 子导航：subnav 菜单：menu 子菜单：submenu 搜索：search 友谊链接：friendlink 页脚：footer 版权：copyright 转动：scroll 内容：content 标签页：tab 文章列表：list 提示信息：msg 小技术：tips 栏目题目：title 加入：joinus 指南：guild 效劳：service 注册：regsiter 状态：status 投票：vote 合作伙伴：partner(二)注释的写法: /* Footer *

14、/ 内容区 /* 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 摘要

15、: summary (3)功能 标志：logo 广告：banner 登岸：login 登录条：loginbar 注册：regsiter 搜索：search 功能区：shop 题目：title 加入：joinus 状态：status 按钮：btn 转动：scroll 标签页：tab 文章列表：list 提示信息：msg 当前的: current 小技术：tips 图标: icon 注释：note 指南：guild 效劳：service 热点：hot 新闻：news 下载：download 投票：vote 合作伙伴：partner 友谊链接：link 版权：copyright大体样式： /* CS

16、S Document */body margin:0; padding:0; font:12px 5B8B4F53,san-serif;background:#fff;div,dl,dt,dd,ul,ol,li,h1,h2,h3,h4,h5,h6,pre,form,fieldset,input,textarea,blockquote,ppadding:0; margin:0; table,td,tr,thfont-size:12px;lilist-style-type:none;imgvertical-align:top;border:0;ol,ul list-style:none;h1,h2

17、,h3,h4,h5,h6 font-size:12px; font-weight:normal;address,cite,code,em,th font-weight:normal; font-style:normal;.fBfont-weight:bold;.f12pxfont-size:12px;.f14pxfont-size:14px;.leftfloat:left;.rightfloat:right;a color:#2b2b2b; text-decoration:none;a:visited text-decoration:none;a:hover color:#ba2636;tex

18、t-decoration:underline;a:active color:#ba2636;重概念的最先，伪类第二，自概念最后，便于自己和他人阅读！ 不同阅读器上字号维持一致，字号建议用点数pt和像素px来概念，pt一样利用中文宋体的9pt和11pt，px一样利用中文宋体12px和这是通过优化的字号，黑体字或宋体字加粗时，一样选用11pt和的字号比较适合。中英文混排时，咱们尽可能的将英文和数字概念为verdana和arial两种字体。 html 书写标准1.网页制作细节 - head区代码标准 head区是指HTML代码的和之间的内容。 必需加入的标签 a)公司版权注释 b)网页显示字符集 简

19、体中文：繁体中文：英 语：c)网页制作者信息 d)网站简介 e)搜索关键字 f)网页的css标准 g)网页题目 xxxxxxxxxxxxxxxxxx能够选择加入的标签 a)设定网页的到期时刻。一旦网页过时，必需到效劳器上从头调阅。 b)禁止阅读器从本地机的缓存中调阅页面内容。 c)用来避免他人在框架里挪用你的页面。d)自动跳转。e)META HTTP-EQUIV=Refresh CONTENT=5;URL=http： f)附标签： 标签不属于head区，那个地址强调一下，为了保证阅读器的兼容性，必需设置页面背景2.网页制作细节 - 字体1. 在设定字体样式时关于文字字号样式和行间距应必需利用C

20、SS样式表。禁止在页面中显现 标记。2.在网页中中文应首选利用宋体。英文和数字首选利用verdana和arial两种字体。一样利用中文宋体的9pt和11pt 或12px和这是通过优化的字号，黑体字或宋体字加粗时，一样选用11pt和的字号比较适合。3. 为了最大程度的发挥阅读器自动排版的功能，在一段完整的文字中请尽可能不要利用 来人工干与分段。4.不同语种的文字之间应该有一个半角空格，但避头的符号之前和避尾的符号以后除外，汉字之间的标点要用全角标点，英文字母和数字周围的括号应该利用半角括号。 5. 请不要在网页中持续显现多于一个的 也尽可能少利用全角空格（英文字符集下，全角空格会变成乱码），空白

21、应该尽可能利用 text-indent, padding, margin, hspace, vspace 和透明的gif 图片来实现。 6. 行距建议用百分比来概念，经常使用的两个行距的值是line-height:120%/150%. 7. 排版中咱们常常会碰到需要进行首行缩进的处置，不要利用 或全角空格来达到成效，标准的做法是在样式表中概念 p text-indent: 2em; 然后给每一段加上 标记，注意，一样情形下，请不要省略 终止标记 。3.网页制作细节 - 链接1. 网站中的链接途径全数采纳相对途径，一样链接到某一目录下的缺省文件的链接途径没必要写全名，如咱们没必要如此： 而应该如

22、此：，所有内页指向首页的链接写成2. 在阅读器里，当咱们点击空链接时，它会自动将当前页面重置到首端，从而阻碍用户正常的阅读内容，咱们用代码“javascript:void(null)”代替原先的“#”标记4.网页制作细节 - 表格1px表格 style=border-collapse: collapse实例如下： 设置亮、暗边框颜色表格有亮边框（bordercolorlight）和暗边框（bordercolordark）两个属性能够对表格样式设置。在写 相互嵌套时，严格依照的标准，关于单独的一个来讲，对齐， 缩进两个半角空格， 中若是还有嵌套的表格，也缩进两个半角空格，若是中没有任何嵌套的表格， 终止标记应该与 处于同一行，不要换行，如咱们注意在源代码中不该有如此的代码： 而应该是如此的：这是因为阅读器以为换行相当于一个半角空格，以上不标准的写法相当于无心中增加一个半角空格，若是确实有必要增加一个半角空格，也应该如此写： 一个网页要尽可能幸免用整个一张大表格，所有的内容都嵌套在那个大表格之内，因为阅读器在说明页面的元素时，是以表格为单位一一显示，