2022年Web前端开发规范手册 .pdf
《2022年Web前端开发规范手册 .pdf》由会员分享,可在线阅读,更多相关《2022年Web前端开发规范手册 .pdf(13页珍藏版)》请在淘文阁 - 分享文档赚钱的网站上搜索。
1、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 文件命名规则
2、文件名称 统一用小写 的英文字母、数字和下划线的组合,其中不得包含汉字、空格和特殊字符;命名原则的指导思想一是使得你自己和工作组的每一个成员能够方便的理解每一个文件的意义,二是当我们在文件夹中使用“按名称排例”的命令时,同一种大类的文件能够排列在一起,以便我们查找、修改、替换、计算负载量等等操作。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 1 页,共 13 页 - - - - - - - - - a. HTML 的命名原则引文件统一使用index.htm index.html i
3、ndex.asp文件名 (小写)各子页命名的原则首先应该以栏目名的英语翻译取单一单词为名称。例如:关于我们 aboutus 信息反馈 feedback 产 品 product 如果栏目名称多而复杂并不好以英文单词命名,则统一使用该栏目名称拼音或拼音的首字母表示;每一个目录中应该包含一个缺省 的 html 文件,文件名统一用index.htm index.html index.asp;b. 图片的命名原则图片的名称分为头尾两部分,用下划线隔开,头部分表示此图片的大类性质例如:广告、标志、菜单、按钮等等。放置在页面顶部的广告、装饰图案等长方形的图片取名:banner 标志性的图片取名为:logo
4、在页面上位置不固定并且带有链接的小图片我们取名为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.gif c. ja
5、vascript 的命名原则例如:广告条的javascript文件名为ad.js 弹出窗口的javascript 文件名为pop.js d. 动态语言文件命名原则以性质 _描述,描述可以有多个单词,用“_”隔开,性质一般是该页面得概要。范例: register_form.asp register_post.asp topic_lock.asp2.2 文件存放位置 规范_Root cn 存放中文HTML 文件en 存放英文HTML 文件flash 存放 Flash 文件images 存放图片文件imagestudio 存放 PSD 源文件flashstudio 存放 flash 源文件inc 存
6、放 include 文件library 存放 DW 库文件media 存放多媒体文件project 存放工程项目资料名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 2 页,共 13 页 - - - - - - - - - temp 存放客户原始资料js 存放 JavaScript 脚本css 存放 CSS 文件2.3 CSS 书写规范基本原则:CSS 样式可细分为3 类:自定义样式、重新定义HTML 样式、链接状态样式。1. 样式为设计师自定义的新CSS 样式,影响被使用本样式的区域
7、,用于完成网页中局部的样式设定。样式名“.”+“相应样式效果描述的单词或缩写”例:“ .shadow”文字样式样式名“.no”+“字号 ”+“行距 ”+“颜色缩写 ”例: “ .no12” 、 “ .no12-24”2. 义 HTML 样式为设计师重新定义已有的HTML 标签样式,影响全部的被设定标签样式,用于统一网页中某一标签的样式定义。样式名“HTML 标签 ”例: hr border: 1px dotted #333333 3. 态样式为设计师对链接不同状态设定特殊样式,影响被使用本样式区域中的链接。该样式写法有2 种:a.nav :link nav.a:link 第一种只能修饰 标签中
8、;第二种可以修饰所有包含有标签的其他标签。页面内的样式加载必须用链接方式 注意细则:1. 协作开发及分工: i 会根据各个模块 , 同时根据页面相似程序, 事先写好大体框架文件, 分配给前端人员实现内部结构&表现 &行为; 共用 css 文件 base.css由 i 书写 , 协作开发过程中 , 每个页面请务必都要引入, 此文件包含reset 及头部底部样式 , 此文件不可随意修改; 2. class 与 id 的使用 : id 是唯一的并是父级的, class 是可以重复的并是子级的, 所以 id 仅使用在大的模块上 , class 可用在重复使用率高及子级中; id 原则上都是由我分发框架
9、文件时命名的, 为 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 命名(此条重要 , 若有不明
10、白请及时与i 沟通 ): a, 通过从属写法规避, 示例见 d; b, 取父级元素id/class 命名部分命名 , 示例见 d; c, 重复使用率高的命名, 请以自己代号加下划线起始, 比如 i_clear; d, a,b两 条 , 适 用 于 在2 中 已 建 好 框 架 的 页 面 , 如 , 要 在2中 已 建 好 框 架 的 页 面 代 码 中加入新的div 元素 , 按 a 命名法则 : ., 样式写法 : #mainnav .firstnav. 按 b 命名法则 : ., 样式写法 : .main_firstnav. 6. css 属性书写顺序 , 建议遵循布局定位属性 -自身属
11、性 -文本属性 -其他属性 . 此条可根据自身习惯书写 , 但尽量保证同类属性写在一起. 属性列举 : 布局定位属性主要包括: margin 、padding 、float(包括名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 3 页,共 13 页 - - - - - - - - - clear ) 、position(相应的top,right,bottom,left) 、display 、visibility 、overflow 等;自身属性主要包括: width & height
12、& background & border; 文本属性主要包括:font、color 、text-align 、text-decoration 、text-indent等;其他属性包括: list-style( 列表样式 )、vertical-vlign 、cursor 、z-index( 层叠顺序 ) 、zoom 等.我所列出的这些属性只是最常用到的, 并不代表全部 ; 7. 书写代码前 , 考虑并提高样式重复使用率; 8. 充分利用 html 自身属性及样式继承原理减少代码量, 比如 : 这儿是标题列表2010-09-15 定义 ul.list liposition:relative ul
13、.list li spanposition:absolute; right:0 即可实现日期居右显示9. 样式表中中文字体名, 请务必转码成unicode 码, 以避免编码错误时乱码; 10. 背景图片请尽可能使用sprite 技术 , 减小 http 请求 , 考虑到多人协作开发, sprite 按模块制作 ; 11. 使用 table 标签时 (尽量避免使用table 标签 ), 请不要用 width/ height/cellspacing/cellpadding等 table属 性 直 接 定 义 表 现 , 应 尽 可 能 的 利 用table自 身 私 有 属 性 分 离 结 构 与
14、 表 现 , 如thead,tr,th,td,tbody,tfoot,colgroup,scope; (cellspaing及cellpadding的css控制方法: tableborder:0;margin:0;border-collapse:collapse; table th, table tdpadding:0; , base.css文件中我会初始化表格样式 ) 12. 杜绝使用 兼容 ie8; 13. 用 png 图片做图片时 , 要求图片格式为png-8 格式 ,若 png-8 实在影响图片质量或其中有半透明效果, 请为 ie6 单独定义背景 : background:none;_
15、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 尾
16、: footer 导航: nav 侧栏: sidebar 栏目: column 页面外围控制整体布局宽度:wrapper 左右中: left right center 登录条: loginbar 标志: logo 广告: banner 页面主体: main 热点: hot 新闻: news 下载: download 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 4 页,共 13 页 - - - - - - - - - 子导航: subnav 菜单: menu 子菜单: submen
17、u 搜索: search 友情链接: friendlink 页脚: footer 版权: copyright 滚动: scroll 内容: content 标签页: tab 文章列表: list 提示信息: msg 小技巧: tips 栏目标题: title 加入: joinus 指南: guild 服务: service 注册: regsiter 状态: status 投票: vote 合作伙伴: partner (二)注释的写法 : /* Footer */ 内容区/* End Footer */ (三)id 的命名 : (1) 页面结构容器 : container 页头: header
18、内容: content/container 页面主体: main 页尾: footer 导航: nav 侧栏: sidebar 栏目: column 页面外围控制整体布局宽度:wrapper 左右中: left right center (2) 导航导航: nav 主导航: mainbav 子导航: subnav 顶导航: topnav 边导航: sidebar 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 5 页,共 13 页 - - - - - - - - - 左导航: lef
19、tsidebar 右导航: rightsidebar 菜单: menu 子菜单: submenu 标题 : title 摘要 : summary (3) 功能标志: logo 广告: banner 登陆: login 登录条: loginbar 注册: regsiter 搜索: search 功能区: shop 标题: title 加入: joinus 状态: status 按钮: btn 滚动: scroll 标签页: tab 文章列表: list 提示信息: msg 当前的 : current 小技巧: tips 图标 : icon 注释: note 指南: guild 服务: servi
20、ce 热点: hot 新闻: news 下载: download 投票: vote 合作伙伴: partner 友情链接: link 版权: copyright 基本样式:/* CSS 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
21、-size:12px; 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 6 页,共 13 页 - - - - - - - - - lilist-style-type:none; imgvertical-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; fo
22、nt-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;text-decoration:underline; a:active color:#ba2636;重定义的最先,伪类其次,自定义最后,便于自己和他人阅读!不同浏览器上字号保持一
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 2022年Web前端开发规范手册 2022 Web 前端 开发 规范 手册
限制150内