技術標籤：前端htmlcssjavascript

一、規範目的

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.gif

c. javascript的命名原則
例如：廣告條的javascript檔名為 ad.js 彈出視窗的javascript檔名為 pop.js

d. 動態語言檔案命名原則
以性質_描述，描述可以有多個單詞，用“_”隔開，性質一般是該頁面得概要。
範例：register_form.asp register_post.asp topic_lock.asp

2.2 檔案存放位置規範

_Root
cn 存放中文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 第一種只能修飾標籤中；第二種可以修飾所有包含有標籤的其他標籤。
   頁面內的樣式載入必須用連結方式

注意細則：

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元素,
   按a命名法則: … ,
   樣式寫法: #mainnav .firstnav{…}
   按b命名法則: … ,
   樣式寫法: .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自身屬性及樣式繼承原理減少程式碼量, 比如:

• 這兒是標題列表2010-09-15

定義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. 杜絕使用 相容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
加入：joinus
指南：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
功能區：shop
標題：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 的字號比較合適。中英文混排時，我們儘可能的將英文和數字定義為verdana 和arial 兩種字型。

2.4 html 書寫規範

1. 網頁製作細節 ---- head區程式碼規範
head區是指HTML程式碼的和之間的內容。
必須加入的標籤
a) 公司版權註釋 <!— The site is designed by EHM,Inc 07/2005 —>
b) 網頁顯示字符集
簡體中文：
繁體中文：
英 語：
c) 網頁製作者資訊
d) 網站簡介
e) 搜尋關鍵字
f) 網頁的css規範
g) 網頁標題
可以選擇加入的標籤
a) 設定網頁的到期時間。一旦網頁過期，必須到伺服器上重新調閱。

b) 禁止瀏覽器從本地機的快取中調閱頁面內容。 c) 用來防止別人在框架裡呼叫你的頁面。 d) 自動跳轉。 5指時間停留5秒 e) 網頁搜尋機器人嚮導。用來告訴搜尋機器人哪些頁面需要索引，哪些頁面不需要索引。 CONTENT的引數有all,none,index,noindex,follow,nofollow。預設是all。 f) 收藏夾圖示 g) 所有的javascript的調用盡量採取外部呼叫. h) 附標籤： 標籤不屬於head區，這裡強調一下，為了保證瀏覽器的相容性，必須設定頁面背景

2. 網頁製作細節 ---- 字型

1. 在設定字型樣式時對於文字字號樣式和行間距應必須使用CSS樣式表。禁止在頁面中出現 標記。

2.在網頁中中文應首選使用宋體。英文和數字首選使用verdana 和arial 兩種字型。一般使用中文宋體的9pt 和11pt 或12px 和14.7px 這是經過優化的字號，黑體字或者宋體字加粗時，一般選用11pt 和14.7px 的字號比較合適。

3. 為了最大程度的發揮瀏覽器自動排版的功能，在一段完整的文字中請儘量不要使用
   來人工干預分段。

4.不同語種的文字之間應該有一個半形空格，但避頭的符號之前和避尾的符號之後除外，漢字之間的標點要用全形標點，英文字母和數字周圍的括號應該使用半形括號。

5. 請不要在網頁中連續出現多於一個的 也儘量少使用全形空格（英文字符集下，全形空格會變成亂碼），空白應該儘量使用 text-indent, padding, margin, hspace, vspace 以及透明的gif 圖片來實現。

6. 行距建議用百分比來定義，常用的兩個行距的值是line-height:120%/150%.

7. 排版中我們經常會遇到需要進行首行縮排的處理，不要使用 或者全形空格來達到效果，規範的做法是在樣式表中定義 p { text-indent: 2em; } 然後給每一段加上

   標記，注意，一般情況下，請不要省略

   結束標記 。

3. 網頁製作細節 ---- 連結

1. 網站中的連結路徑全部採用相對路徑，一般連結到某一目錄下的預設檔案的連結路徑不必寫全名，如我們不必這樣： 而應該這樣：，所有內頁指向首頁的連結寫成

2. 在瀏覽器裡，當我們點選空連結時，它會自動將當前頁面重置到首端，從而影響使用者正常的閱讀內容，我們用程式碼“javascript:void(null)”代替原來的“#”標記

4. 網頁製作細節 ---- 表格
1px表格 style=“border-collapse: collapse”
例項如下：

設定亮、暗邊框顏色 表格有亮邊框（bordercolorlight）和暗邊框（bordercolordark）兩個屬性可以對錶格樣式設定。

在寫

互相巢狀時，嚴格按照的規範，對於單獨的一個 來說， 對齊，

縮排兩個半形空格，

中如果還有巢狀的表格，也縮排兩個半形空格，如果 結束標記應該與 中沒有任何巢狀的表格， 處於同一行，不要換行， 如我們注意在原始碼中不應有這樣的程式碼：

而應該是這樣的： 這是因為瀏覽器認為換行相當於一個半形空格，以上不規範的寫法相當於無意中增加一個半形空格，如果確實有必要增加一個半形空格，也應該這樣寫：

一個網頁要儘量避免用整個一張大表格，所有的內容都巢狀在這個大表格之內，因為瀏覽器在解釋頁面的元素時，是以表格為單位逐一顯示，如果一張網頁是巢狀在一個大表格之內，那麼很可能造成的後果就是，當瀏覽者敲入網址，他要先面對一片空白很長時間，然後所有的網頁內容同時出現。如果必須這樣做，請使用 標記，以便能夠使這個大表格分塊顯示

5. 網頁製作細節 ---- 下載速度
首頁Flash 網頁大小應限定在 200K 以下，儘可能的使用向量圖形和Action來減小動畫大小。非首頁靜態頁面含圖片大小應限定在 70K 左右，儘可能的使用背景顏色替換大塊同色圖片。

6. 網頁製作細節 ---- include
asp標準寫法
jsp 標準寫法 <%@ include file="…/inc/index_top…jsp" %>

7. 網頁製作細節 ---- Alt和Title
都是提示性語言標籤，請注意它們之間的區別。
在我們瀏覽網頁時，當滑鼠停留在圖片物件或文字連結上時，在滑鼠的右下角有時會出現一個提示資訊框。對目標進行一定的註釋說明。在一些場合，它的作用是很重要的。
alt 用來給圖片來提示的。Title用來給連結文字或普通文字提示的。
用法如下：

文字

文字

8. 網頁製作細節 ---- 快取
網頁不會被快取
HTM網頁

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

9. 網頁製作細節 ---- 瀏覽器相容性
建立站點時，應該明白訪問者可能使用各種 Web 瀏覽器。在已知的其他設計限制下，儘可能將站點設計為具有最大的瀏覽器相容性。
目前使用的 Web 瀏覽器有二十多種，大多數已發行了多個版本。即使您只針對使用 Netscape Navigator 和 Microsoft Internet Explorer 的大多數 Web 使用者，但您應明確並不是每個人都在使用這兩種瀏覽器的最新版本。
您的站點越複雜（在佈局、動畫、多媒體內容和互動方面），跨瀏覽器相容的可能性就越小。例如，並非所有的瀏覽器都可以執行JavaScript。不使用特殊字元的純文字頁面或許能夠在任何瀏覽器中正確顯示，但比起有效地使用圖形、佈局和互動的頁面，這樣的頁面在美感上可能要差得多。所以，應儘量在最佳效果設計和最大瀏覽器相容性設計之間取得平衡。
所有的HTML 標籤的屬性都要用單引號或者雙引號括起，即我們應該寫 而不 是 .

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，目前有三種規格：
8831 這是網際網路上最普遍的LOGO規格。
12060 這種規格用於一般大小的LOGO。
120*90 這種規格用於大型LOGO。

12. 圖片處理細節 ---- 頁面修飾圖片處理
圖片經過優化以加快下載的速度,有較佳的視覺空間效果，用圖要與頁面風格、頁面內容相符；製作精美，細節處理得當。

2.5 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, 注重效能.

2.6 圖片規範

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目錄下.

2.7 註釋規範

1. html註釋: 註釋格式 , '–'只能在註釋的始末位置,不可置入註釋文字區域;
2. css註釋: 註釋格式 /這兒是註釋/;
3. JavaScript註釋, 單行註釋使用’//這兒是單行註釋’ ,多行註釋使用 /* 這兒有多行註釋 */;

2.8 瀏覽器相容性 CSS hack

一、標識區別：
區別IE6,IE7,IE8,FF。

1. IE都能識別* ; 標準瀏覽器(如FF)不能識別*；
2. IE6能識別*，但不能識別 !important; IE6在樣式前面加_
3. IE7能識別*，也能識別!important;
4. IE8能識別\ 9 例如：background:red \9;
5. firefox不能識別*，但能識別!important;

1．IE6和firefox的區別：
background:orange;*background:blue;
意思就是火狐瀏覽器的背景顏色是橙色,而IE瀏覽器的背景色是藍色.
2. IE6和IE7的區別：
background:green !important;background:blue;
意思指的是:IE7的背景顏色是綠色,IE6的背景顏色是藍色
3. IE7和FF的區別：
background:orange; *background:green;
意思指的是:火狐瀏覽器的背景顏色是橙色,而IE7的背景顏色是綠色
4. FF，IE7，IE6的區別：
background:orange;
*background:green !important;
*background:blue;
意思是火狐瀏覽器的的背景橙色,IE7瀏覽器的背景顏色是綠色,而IE6瀏覽器的顏色是藍色.

二、實踐建議
(1). 開發平臺的選擇
在 Firefox 上編寫CSS, 同時相容其他瀏覽器的. 這樣做肯定會比在 IE 做好再到別的瀏覽器相容來得容易, 因為 IE 對老標準支援還是很不錯的, 而 IE 的一些特有功能人家卻不支援. 所以推薦以 Firefox 結合 Firebug 擴充套件作為平臺。
(2). CSS Hack 的順序
使用 Firefox 作為平臺, 只要程式碼寫得夠標準, 其實要 Hack 的地方不會很多的, IE 以外的瀏覽器幾乎都不會有問題, 所以可以暫時忽略,
順序如下：Firefox -> IE6 -> IE7 -> 其他
(3). Hack 的方法
說到方法有兩種, 一種是在不同檔案中處理, 另一種則是在同一個檔案中處理. 其實作用是相同的, 只是出發點不一樣而已.

1. 同一檔案中處理.
   如: id="bgcolor"的控制元件要在 IE6中顯示藍色, IE7中顯示綠色, Firefox等其他瀏覽器中顯示紅色。

IE6不認 !important,也不認 *+html.所以 IE6只能是 blue.
IE7認 !important,也認 +html,優先度: (+html + !important) > !important > +html. IE7可以是 red, blue和 green,但 green的優先度最高.
Firefox和其他瀏覽器都認 !important. !important優先, Firefox可以是 red和 blue,但 red優先度高.上述的優先符號均是 CSS3標準允許的,其他瀏覽器也還有其他的 Hack方法,但我迄今還沒遇到過 Firefox正常, IE以外的其他瀏覽器不正常的情況,所以無可分享.只要程式碼規範,相信這種情況的發生應該是很罕見 (JavaScript除外).
2. 不同檔案中處理.
為什麼同一檔案中可以處理還要寫在多個檔案裡面針對不同的瀏覽器?這是為了欺騙 W3C的驗證工具,其實只需要兩個檔案,一個是針對所有瀏覽器的,一個只為 IE服務.將所有符合 W3C的程式碼寫到一個裡面去,而一些 IE中必須的,又不能通過 W3C驗證的程式碼 (如: cursor:hand;)放到另一個檔案中,再用下面的方法匯入.