Google推薦的15條軍規:HTML5代碼規範
今天無意間看到了Google的HTML/CSS編碼規範,發現了不少自己很容易忽略的問題,特意仔細看了看,將其整理翻譯出來分享給大家。Google規範的原文鏈接大家可以訪問:http://google-styleguide.googlecode.com/svn/trunk/htmlcssguide.xml
1.協議頭:
建議在指向圖片或其他媒體文件、樣式表和腳本的URL地址中省略http:https:協議部分,除非已知相應文件不能同時兼容2個協議。
注:這個倒是真正平日不注意的,只要是絕對地址,http:總是帶着。如果仔細想一想,還真有道理。
2.縮進:每次縮進使用雙空格
不要使用tab製表符或製表符加空格的混合方式縮進
3.大小寫:只使用小寫
所有的代碼都應是小寫的,包括元素名稱、屬性,屬性值(除非text或CDATA的內容)、選擇器、css屬性、屬性值(字符串除外)
4.尾隨空格
尾隨空格是不必要的,容易搞複雜diff文件。這個絕對是經驗教訓的總結!!!
5.編碼格式:使用UTF-8
請確保您的編輯器使用的字符編碼??爲UTF-8,沒有字節順序標記。在html模板或文檔中通過
來
定義編碼格式。關於編碼格式參考 Character Sets
& Encodings in XHTML, HTML and CSS
6.註釋
根據需要解釋代碼,這個就不多說了,團隊開發這個非常重要,儘管很多時候大家不願意遵守,但確實重要!!!
7.TODO待定項
尚未實現的或待定的內容一定要標識強調出來,利用TODO辨識,而非其他諸如@@來強調。
在todo項中如果有必要列明聯繫人,比如負責人
在TODO後追加一個冒號作爲行動內容,例如 TODO:爲美瑞網增加html5模板
8.文檔類型:使用HTML5
使用.HTML(text/html)類型文件相對XHTML(alication/xhtml+xml)文件,在瀏覽器及框架支持上和優化空間上都要好很多。
9.HTML 合法性驗證
合法的使用HTML,並利用w3c的工具(W3C HTML validator)進行檢查。唯一例外就是因爲性能原因需要壓縮文件大小。
原文如下:Use valid HTML code unless
that is not possible due to otherwise unattainable performance goals regarding file size. 但這個確實很難想象,省略標籤節省的文件大小能有多少字節?但帶來的問題可是風險居高哦!
10.語義性
根據目的來合理使用HTML,這點對於HTML5而言尤爲重要。下面例子可以對比,能實現同樣的結果,但效率和可讀性卻有很大差別。
對於HTML5而言,例如header、footer、nav、section等跟div能實現的功能基本類似,但是語義性上有着天壤之別。
11.多媒體後備:爲多媒體提供備選內容
這個屬於老生長談的內容,典型就是爲img添加alt內容。
12.關注點分離
這點很重要,嚴格遵守將組織結構(markup)、表現樣式(style)和行爲動作(script)分開處理的原則,並且儘量使三者之間的關聯度降到最小。這主要是基於維護性的考慮,通常,更新style文件或腳本文件比更改HTML文件的代價要小很多,試想一下,對於一個有超過10萬頁面的網站進行局部顏色調整,是每個html文件修改容易還是修改一個style文件容易?
可選Tags:省略可選的標籤
13.實體引用
假定開發團隊內,文件和編輯器都是使用同樣的編碼格式(UTF-8),則沒有必要使用實體引用的方式,例如—,”,
or ☺ 除非一些HTML中具有特定含義的字符,如”<”,或不可見字符如空格
14.Type屬性:省略
將樣式表和腳本中的Type省略,除非你不是用的css或javascript,在HTML5中,該值默認是text/css和text/javascript
15.block,list或table元素
針對每個block,list或table元素另起一行,並在每個子元素前縮進。這樣可讀性好,例如:
對於使用HTML5的朋友,可以參考。當然,不同團隊還會整理出適合自己的代碼規範,上述應該來說屬於比較基本的規則內容。
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.