網站制作規(guī)范目的
為提高團隊協(xié)作效率,便于后臺人員添加功能及前端后期優(yōu)化維護,輸出高質量的文檔, 特制訂此文檔。本規(guī)范文檔一經確認,前端開發(fā)人員必須按本文檔規(guī)范進行前臺頁面開發(fā),本文檔如有不對或者不合適的地方請及時提出。經討論決定后方可更改。
網站制作基本準則
符合web標準,語義化html,結構表現(xiàn)行為分離, 兼容性優(yōu)良。 頁面性能方面,代碼要求簡潔明了有序,盡可能的減小服務器負載,保證最快的解析速度。
網站制作文件規(guī)范
1、html, css, js, images文件均歸檔至<系統(tǒng)開發(fā)規(guī)范>約定的目錄中;
2、html文件命名: 英文命名, 后綴.htm。 同時將對應界面稿放于同目錄中,若界面稿命名為中文,請重命名與html文件同名, 以方便后端添加功能時查找對應頁面;
3、css文件命名: 英文命名, 后綴.css. 共用style.css,其他頁面依實際模塊需求命名;
4、 Js文件命名: 英文命名, 后綴.js. 共用common.js, 其他依實際模塊需求命名.
網站建設html書寫規(guī)范
1、文檔類型聲明及編碼: 統(tǒng)一為html5聲明類型; 編碼統(tǒng)一為, 書寫時利用IDE實現(xiàn)層次分明的縮進;
2、非特殊情況下樣式文件必須外鏈至...之間;非特殊情況下JavaScript文件必須外鏈至頁面底部;
3、引入樣式文件或JavaScript文件時, 須略去默認類型聲明, 寫法如下:
...
<!-- Inject Script Filtered -->
4、引入JS庫文件, 文件名須包含庫名稱及版本號及是否為壓縮版, 比如jquery-1.4.1.min.js; 引入插件, 文件名格式為庫名稱+插件名稱, 比如jQuery.cookie.js;
5、 所有編碼均遵循xhtml標準, 標簽 & 屬性 & 屬性命名 必須由小寫字母及下劃線數(shù)字組成, 且所有標簽必須閉合, 包括 br, hr等; 屬性值必須用雙引號包括;
6、充分利用無兼容性問題的html自身標簽, 比如span, em, strong, optgroup, label,等等; 需要為html元素添加自定義屬性的時候, 首先要考慮下有沒有默認的已有的合適標簽去設置, 如果沒有, 可以使用須以"data-"為前綴來添加自定義屬性,避免使用"data:"等其他命名方式;
7、 語義化html, 如 標題根據(jù)重要性用h*(同一頁面只能有一個h1), 段落標記用p, 列表用ul, 內聯(lián)元素中不可嵌套塊級元素;
8、在頁面中盡量避免使用style屬性,即style="…";
9、能以背景形式呈現(xiàn)的圖片, 盡量寫入css樣式中;
10、 重要圖片必須加上alt屬性; 給重要的元素和截斷的元素加上title;
11、給區(qū)塊代碼及重要功能(比如循環(huán))加上注釋, 方便后臺添加功能;
12、特殊符號使用: 盡可能使用代碼替代: 比如 <(<) & >(>) & 空格( ) & »(») 等等;
13、 書寫頁面過程中, 請考慮向后擴展性;
14、class & id 參見 css書寫規(guī)范.