網站制作規(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ī)�.