WEB前端編碼規(guī)范
《WEB前端編碼規(guī)范》由會員分享,可在線閱讀,更多相關《WEB前端編碼規(guī)范(47頁珍藏版)》請在裝配圖網(wǎng)上搜索。
1、 XXXX有限公司 XXXXXXXX管理平臺 Web 前端代碼編寫規(guī)范 文件狀態(tài): 文件標識: [ √ ] 草稿 當前版本: 1.0 [ ] 正式發(fā)布 作 者: 李光強 [ ] 正在修改 完成日期: 2016.1.30 XXXXXX 2016 年 1
2、 月 修改歷史 修訂后 修訂人 修訂 編號 修訂內(nèi)容簡述 版本號 日期 11.0 李光強 起草 2016.1.30 第一部分 HTML 規(guī)范 HTML并不是一種編程語言,而是一種標記語言,它沒有任何真正的編程語 言中的循環(huán)或是流程控制語句。然而, HTML代碼的格式和風格是非常重要的,因為要經(jīng)常對 HTML代碼進行維護和修改, 因此 HTML代碼必須有很清晰的邏輯結(jié)構(gòu)和布局,而使其易懂和易于維護。 HTML語言是不區(qū)分大小寫的,但為改善
3、可讀性,規(guī)定小寫所有字母(除最 上一行引用外) 。與 HTML不一樣, XHTML對大小寫是敏感的,
4、 2. 網(wǎng)站 head 區(qū)代碼規(guī)范: head 區(qū)是指
和 之間的內(nèi)容。必須加入的標簽: 2.1 公司版權注釋 2.2 網(wǎng)頁顯示字符集 簡體中文 : 繁體中文:5、ta http-equiv="Content-Type" content="text/html; charset= BIG5"> 英 語: 2.3 作者與版權信息 此處用于存儲開發(fā)公司版權信息,如: 2.4 網(wǎng)頁的 c
6、ss,javascript 規(guī)范 在引用 CSS和 JS文件時,統(tǒng)一放置在
中,先放 CSS引用,再放 js 引用。 html 中 javascript 的書寫: 2.5 網(wǎng)頁標題 Title 中使用“ - ”分割,如:設備管理平臺 - 運維系統(tǒng)7、。 2.6 設置搜索關鍵詞 百度關鍵詞搜索指數(shù): ,在這個工具里, 可以看到一些常用關鍵詞的每日搜 索次數(shù)。 熱門詞匯,目前收索量最多的詞匯。可以查看百度熱詞榜, Google AdWords 關鍵字工具:查詢特定關鍵詞的常見查詢及擴展匹配。 KEYWRODS關鍵字最多不超過 5 個建議長度:小于等于 100 個漢字,如果使用的網(wǎng)頁編碼是 UTF-8,不同關鍵字之間用英文“ , ”分隔。 2.7 網(wǎng)站簡介
8、 description 是描述網(wǎng)頁內(nèi)容的, 因此最好是可以用一句話來概括本網(wǎng)頁的 主題內(nèi)容。 description 不要超過 255 個字符,搜索引擎索引一般都會索引 Description 的前 255 個字符,因此,這 255 個字符是做搜索引擎優(yōu)化的關鍵。 如果使用的網(wǎng)頁編碼是 UTF-8,那么在 Description 中的標點符號最好都使 用英文,例如英文的逗號、句號等。如果是中文的話,那么就使用中文的標點符 號即可。 2.
9、8 其它標簽 [ 非必需 ] 1. 設定網(wǎng)頁的到期時間。 一旦網(wǎng)頁過期, 必須到服務器上重新調(diào)閱, 這樣有利于頁面信息。 2. 禁止瀏覽器從本地機的緩存中調(diào)閱頁面內(nèi)容。 3. 用來防止別人在框架里調(diào)用你的頁面。 4. 自動跳轉(zhuǎn)。 5 指時間停留 5 秒。 5. 網(wǎng)頁搜索機器人向?qū)?. 用來告訴搜索機器人哪些頁面需要索引,哪些頁面不需要索引。 CONTENT的參數(shù)有 all,none,index,noindex,follow,nofollow 。默認是 all 。 6. 收藏夾圖標 圖片大小 16px*16px 7. 訂閱 RSS瀏覽 是一種描述和同步網(wǎng)站內(nèi)容的格式。用戶可以通過 RSS閱讀器訂閱。 2.9 完整示例
12、 3. html 中元素的書寫:
區(qū)域標簽 3.1 段落 段落使用標簽進行定義。
This is a paragraph
3.2 標題 即正文標題一般用 標簽,最好和 title 標簽的內(nèi)容有關聯(lián)。 標題使用 至 標簽進行定義。 定義最大的標題。 定義
最小的標題。
This
定義最大的標題。 定義
最小的標題。
This
This
13、is a heading
This is a heading
This is a heading
This is a heading
This is a heading
This is a heading
文章中的小標題一定也要加粗。 可以把網(wǎng)頁中的重要內(nèi)容做成這樣。 用戶不用登陸這個網(wǎng)頁就可看到更新的內(nèi)容。 3.3 字體的設置標簽 換行:字體修飾不要使用
14、> 等進行標注,一般使用 css 樣式進行字體 樣式排版 3.4 注意事項 1.
為了保證瀏覽器的兼容性 ,必須設置頁面背景: 2. 關 所有的 打開的 必 關 ,例如 ,當然 有一種關 方式,如:。 即:一定要有 束 。 3. 屬性 用雙引號 “” 括起來 , 屬性 一使用小寫 例如: 4. 所有的屬性 不正確的寫法: 正確的寫法 : 5. 要合理嵌套 不正確的寫法:
16、t 屬性指定了當 片不能 示的 候就 示供替 文本。 內(nèi)容最好與關 相關。 如: 一些小 最好用 .png 或 .gif 格式 片,比如 箭 ,文章列表前的 等,在 CSS中做成背景。 些小 最好做一 片,用 CSS來定位。 9. 用 構(gòu)化的元素 出內(nèi)容
- 新現(xiàn)代
- 新現(xiàn)代
- 新現(xiàn)代
- <
17、/dt>
?? | ? .
19、 4. HTML 元素的排序規(guī)則 能夠使用的 HTML元素包括: div 、p、ul 、table 、span、input 、select 等?;旧?div 、table 、ul 、p 都屬于結(jié)構(gòu)性比較強的元素,而 span、input 則是比較弱的元素,因此不允許有 span 嵌套 div 、 table 等等的情況出現(xiàn), span 可以嵌套 input, 可以嵌套 span。 在寫頁面的時候可以先不考慮界面呈現(xiàn), 按照這樣的規(guī)則, 把數(shù)據(jù)直接綁定到 HTML元素的節(jié)點上。 5. 九大原則 原則一: 一般要寫兼容多種瀏覽器的
20、網(wǎng)頁, 最省事的方法就先寫適合 chrome 的樣式,并在 chrome 進行調(diào)度。測試時可以使用多種瀏覽器。 原則二: 逐步疊加的方式,如果需要用這個樣式的模塊很多, 并且會存在些許的不同,千萬不要把樣式一步寫到位, 最好把框架性的先寫好, 細節(jié)性的留到第二個步驟,甚至第三個步驟,當然最好步驟不要超過三步,這樣很不利于維護。 由若干個二級定義對一級定義進行補充, 這樣的既可以減少代碼, 又可以減少繁多的 CLASS命名。 不要輕易修改共用的 CSS,否則可能會影響其它頁面。 在每個一級 CSS前添加注釋,說明哪些頁面使用了該 CSS。
21、 原則三: 從總到分。順序應該是這樣:總體需要用到的 >>結(jié)構(gòu) >>模塊 >>二級模塊 >> 細節(jié);并且這個文檔最不容易修改的處于最上端, 頻繁用于修改的在末端。 最忌諱即興發(fā)揮, 這樣寫出的東西經(jīng)不起推敲, 稍有變化就要忙得亂成一團。 結(jié)構(gòu)性的東西應該慎重精細。 原則四: 盡量把能夠放在一組的小圖標或者圖片放在一個圖片文件里, 這樣的好處有很多。 1、 圖片文件的總量會變??; 2、利于下載,太多的小圖片下載效果是不理想的,常常會發(fā)現(xiàn)這個圖片出 來,那個沒出來, 這樣在寫樣式的時候只需要寫一個總體的, 對于具體的要顯
22、示 的只需要標一個位置,非常省時間,樣式也很精煉; 3、 顯而易見,這樣做非常便于管理,替換或新增的時候工作量很小。 原則五: 切圖的原則, 應該切大的圖絕不切小, 應該切小的絕不切大, 能夠用顏色代替的絕不切圖。 把一個大圖切成很多份并不一定能夠加快頁面的顯示速度, 相反會浪費很多不必要的帶寬。 不光要控制圖片文件的多少, 還要考慮到這樣切會不會造成頁面增加許多額外的代碼。 原則六: 圖片使用能名稱表達圖片意義的名詞命名,盡量不要使用編號命名。 原則七: 涉及多行多列的特別是列寬有不固定的,堅決用表格,千萬不要為
23、了 DIV 而 DIV。 多個圖片規(guī)則排列時,可以使用
24、模塊(子系統(tǒng))單獨創(chuàng)建一個文件夾,使 用與之相關的有意義的英文名詞命名。 例如有一個系統(tǒng)包括后臺管理 (admin)、 前臺商城( shop)、會員中心( member)和商家中心( store )等子系統(tǒng),文件 夾組織: 每個子系統(tǒng)中應該包含一個缺省的 html 文件,文件名統(tǒng)一用 index.html ,即當用戶缺省訪問該目錄時,自動加載該頁面。 公用頁面(如登錄 login.html 、頁頭 header.html 、頁腳 footer.html 、導 航 navigation.
25、html 、菜單 menu.html 、信息 / 錯誤提示 message.html 等),可以統(tǒng)一放在 common目錄中。 6.2 頁面命名規(guī)則 具有管理功能的頁面,如用名、角色、設備、日志、文章等的管理,可以歸 納為列表( list.htm )、新建( add.html )、編輯( edit.html )等幾類操作, 所以在頁面組織時, 每類模塊單獨創(chuàng)建一個文件夾, 使用能夠表達模塊意義的英 文名詞命名,并在其中分別創(chuàng)建 list.html 、add.html 、 edit.html 等文件,對 應于內(nèi)容列表、添加、編輯等操作。
26、示例: 其它說明: 1. 在列表頁面里統(tǒng)一使用“四欄式”顯示風格,即列表頁面里必須包括模塊目錄 / 位置提示、工具欄(含添加、編輯、刪除、刷新、查詢等操作控件)、表格、分頁操作等部分。示例: 2. 表格用于顯示查詢內(nèi)容,在 list.html 打開時,必須默認加載一定的記錄;表格欄目僅
27、顯示用戶常用或關心的字段; 在顯示時必須對表格內(nèi)容進行必要的格式處理;對記錄常用的操作可以放置于操作欄內(nèi) (如上圖中的操作欄內(nèi)放置有編輯和刪除兩個操作按鈕)。 3. 表格可以統(tǒng)一使用 easyui datagrid 或 bootstap data tables 。 6.3. 資源文件的命名原則 資源文件包括 css 、js 、圖片等內(nèi)容。所有資源文件統(tǒng)一存儲在 web 根目錄 resource 文件夾中。示例:
28、 每個子系統(tǒng)(大類)文件夾命名規(guī)則同 6.1 規(guī)則。 每個子系統(tǒng)文件夾中分別包括 css 、 js 和 images,示例: 多個子系統(tǒng)公共使用的資源,統(tǒng)一存儲在 common文件夾中,如常用的 js 操作,可以命名為 generic.js ,放置在 common/js/generic.js 。 6.3 圖片命名規(guī)則 圖片分成兩部分, 一是網(wǎng)頁設計時使用的靜態(tài)資源, 通常不會因系統(tǒng)的運行而發(fā)生變化,另一類是程序生成、用戶上傳、終端上傳的圖片。 (
29、1)靜態(tài)圖片存儲在 大類目錄 \images 中,使用能表達圖片意 義的英文單詞命名, 不能使用圖片編號命名。 網(wǎng)面使用的小圖標, 可以放置在一個圖片文件中,使用 css 裁切和背景方式顯示在頁面中。 (2)動態(tài)圖片存儲在 resources\upload 目錄中,在其中創(chuàng)建分類圖片目錄。 例如,與系統(tǒng)相關的圖片存儲在 system 目錄中,設備監(jiān)控相關圖片存儲在 management 中等。為了避免同一文件夾中文件數(shù)量限制,在分類目錄中,按上 傳日期分成不同的次級目錄, 命名規(guī)則為上傳文件所在的 yyyyMM(年度月份),其中月份使用
30、兩位數(shù)字表示。例如: 上傳的圖片統(tǒng)一使用 GUID標識進行命名, 即在上傳時,由接收的 java 程序自動生成 guid 編號 +. 圖片擴展名進行命名。 注意:保存圖片時,文件擴展名必須保持不變。示例: 7. 常用 HTML標識符 HTML 標記一覽 : 標記 類型 譯名或意義 作 用 備注 文件標記 ● 文件聲明 讓瀏覽器知道這是 HTML 文件
31、● 開頭 提供文件整體資訊
○
段落標記
為字、畫、表格等之間留一空白行
○
換行標記
令字、畫、表格等顯示于下一行
○ 水平線 插入一條水平線
● 預設格式 令文件按照原始碼的排列方式顯示32、
● 區(qū)隔標記 設定字、畫、表格等的擺放位置● 不折行 令文字不因太長而繞行 ● 建議折行 預設折行部位 字體標記 ● 加重語氣 產(chǎn)生字體加粗 BOLD 的效果 ● 粗體標記 產(chǎn)生字體加粗的效果 ● 強調(diào)標記 字體出現(xiàn)斜體效果 ● 斜體標記 字體出現(xiàn)斜體效果 ● 打字字體 COURIER字體,字母寬度相同 ● 加上底線 加上底線 反對 ● 一級標題標記 變
33、粗變大加寬,程度與級數(shù)反比
● 二級標題標記 將字體變粗變大加寬
● 三級標題標記 將字體變粗變大加寬
● 四級標題標記 將字體變粗變大加寬
● 五級標題標記 將字體變粗變大加寬
● 六級標題標記 將字體變粗變大加寬 ● 字形標記 設定字形、大小、顏色 反對
○ 基準字形標記 設定所有字形、大小、顏色 反對 ● 字體加大 令字體稍為加大 ● 字體縮細 令字體 34、稍為縮細
● 畫線刪除 為字體加一刪除線 反對● 程式碼 字體稍為加寬如 ● 鍵盤字 字體稍為加寬,單一空白 ● 范例 字體稍為加寬如 ● 變數(shù) 斜體效果 ● 傳記引述 斜體效果
● 引述文字區(qū)塊 縮排字體 ● 述語定義 斜體效果 ● 地址標記 斜體效果 ● 下標字 下標字 ● 上標字35、 指數(shù)(平方、立方等) 清單標記
● 順序清單 清單項目將以數(shù)字、字母順序排列
● 無序清單 清單項目將以圓點排列
- ○ 清單項目 每一標記標示一項清單項目
反對
● 目錄清單 清單項目將以圓點排列,如 反對
● 定義清單 清單分兩層出現(xiàn)
- ○ 定義條目 標示該項定義的標題
- ○ 定義內(nèi)容 標示定義內(nèi)容 表格標記
36、BLE> ● 表格標記 設定該表格的各項參數(shù)
● 表格標題 做成一打通列以填入表格標題 ● 表格列 設定該表格的列 ● 表格欄 設定該表格的欄 ● 表格標頭 相等于 ,但其內(nèi)之字體會變粗 表單標記