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的朋友,可以參考。當然,不同團隊還會整理出適合自己的代碼規範,上述應該來說屬於比較基本的規則內容。
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章