web前端html書寫規(guī)范

html書寫規(guī)范

1.文檔類型聲明及編碼: 統(tǒng)一為html5聲明類型; 編碼統(tǒng)一為 , 書寫時利用IDE實現(xiàn)層次分明的縮進;

2. 非特殊情況下樣式文件必須外鏈至...之間;非特殊情況下JavaScript文件必須外鏈至頁面底部;

3. 引入樣式文件或JavaScript文件時, 須略去默認類型聲明, 寫法如下:

4. 引入JS庫文件, 文件名須包含庫名稱及版本號及是否為壓縮版, 比如jquery-1.4.1.min.js; 引入插件, 文件名格式為庫名稱+插件名稱, 比如jQuery.cookie.js;

5. 所有編碼均遵循xhtml標準, 標簽 & 屬性 & 屬性命名 必須由小寫字母及下劃線數(shù)字組成, 且所有標簽必須閉合, 包括 br (), hr()等; 屬性值必須用雙引號包括;

6. 充分利用無兼容性問題的html自身標簽, 比如span, em, strong, optgroup, label,等等; 需要為html元素添加自定義屬性的時候, 首先要考慮下有沒有默認的已有的合適標簽去設(shè)置, 如果沒有, 可以使用須以"data-"為前綴來添加自定義屬性，避免使用"data:"等其他命名方式;

7. 語義化html, 如 標題根據(jù)重要性用h*(同一頁面只能有一個h1), 段落標記用p, 列表用ul, 內(nèi)聯(lián)元素中不可嵌套塊級元素;

8. 盡可能減少div嵌套, 如

歡迎訪問XXX, 您的用戶名是用戶名

完全可以用以下代碼替代:

歡迎訪問XXX, 您的用戶名是用戶名;

9. 書寫鏈接地址時, 必須避免重定向，例如：href="網(wǎng)址", 即須在URL地址后面加上“/”；

10. 在頁面中盡量避免使用style屬性,即style="…";

11. 必須為含有描述性表單元素(input, textarea)添加label

12. 能以背景形式呈現(xiàn)的圖片, 盡量寫入css樣式中;

13. 重要圖片必須加上alt屬性; 給重要的元素和截斷的元素加上title;

14. 給區(qū)塊代碼及重要功能(比如循環(huán))加上注釋, 方便后臺添加功能;

15. 特殊符號使用: 盡可能使用代碼替代: 比如 <(<) & >(>) & 空格( ) & ?(?) 等等;

16. 書寫頁面過程中, 請考慮向后擴展性;

17. class & id 參見 css書寫規(guī)范.