Google推薦的15條HTML 5代碼軍規
今天無意間看到了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文件。這個絕對是經驗教訓的總結!?。?/p>
5.編碼格式:使用UTF-8
請確保您的編輯器使用的字符編碼??為UTF-8,沒有字節順序標記。在html模板或文檔中通過 <meta charset=”utf-8″>來
定義編碼格式。關于編碼格式參考 Character Sets & Encodings in XHTML, HTML and CSS
6.注釋
根據需要解釋代碼,這個就不多說了,團隊開發這個非常重要,盡管很多時候大家不愿意遵守,但確實重要?。?!
7.TODO待定項
尚未實現的或待定的內容一定要標識強調出來,利用TODO辨識,而非其他諸如@@來強調。
在todo項中如果有必要列明聯系人,比如負責人
在TODO后追加一個冒號作為行動內容,例如 TODO:為美瑞網增加html5模板
8.文檔類型:使用HTML5
使用<!DOCTYPE html>.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的朋友,可以參考。當然,不同團隊還會整理出適合自己的代碼規范,上述應該來說屬于比較基本的規則內容。
原文鏈接:http://www.html5cn.org/article-2975-1.html
【編輯推薦】