前端規範之HTML 規範
其餘規範：
CSS 規範javascript
媒體文件規範css
javascript 規範html
nodeJs 規範vue
vue項目規範java
摘要
優秀的項目源碼，即便是多人開發，看代碼也如出一人之手。統一的編碼規範，可以使代碼更易於閱讀，易於理解，易於維護node
HTML 規範
縮進
統一兩個空格縮進web
命名規範
- class 應以功能或內容命名，不以表現形式命名；
- class 與 id 單詞字母小寫，多個單詞組成時，採用中劃線-分隔；
- 使用惟一的 id 做爲 Javascript hook, 同時避免建立無樣式信息的 class；
DOCTYPE 聲明
HTML 文件必須加上 DOCTYPE 聲明，並統一使用 HTML5 的文檔聲明：chrome
<!DOCTYPE html>
複製代碼
meta 標籤
- 統一使用 「UTF-8」 編碼
<meta charset="utf-8">
複製代碼
- SEO 優化
<!-- 頁面關鍵詞 -->
<meta name ="keywords" content =""/>
<!-- 頁面描述 -->
<meta name ="description" content ="">
<!-- 網頁做者 -->
<meta name ="author" content ="">
複製代碼
- 優先使用 IE 最新版本和 Chrome
<meta http-equiv ="X-UA-Compatible" content ="IE = edge，chrome = 1">
複製代碼
- 爲移動設備添加視口
<!-- device-width 是指這個設備最理想的 viewport 寬度 -->
<!-- initial-scale=1.0 是指初始化的時候縮放大小是1，也就是不縮放 -->
<!-- user-scalable=0 是指禁止用戶進行縮放 -->
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=no">
複製代碼
- 禁止自動識別頁面中有多是電話格式的數字
<meta name="format-detection" content="telephone=no">
複製代碼
團隊約定：app
pc 端：ide
<meta charset="utf-8">
<meta name="keywords" content="your keywords">
<meta name="description" content="your description">
<meta name="author" content="author,email address">
<meta http-equiv="X-UA-Compatible" content="IE=Edge,chrome=1">
複製代碼
移動端：
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=no">
<meta name="format-detection" content="telephone=no">
複製代碼
標籤
html 標籤分爲如下幾類：
- 自閉合標籤（self-closing），無需閉合。例如：area、base、br、col、command、embed、hr、img、input、keygen、link、meta、param、source、track、wbr 等 )
- 閉合標籤（closing tag），需閉合 。例如：textarea、title、h、div、span 等
團隊約定：
- 全部具備開始標籤和結束標籤的元素都必需要寫上起止標籤，某些容許省略開始標籤或和束標籤的元素亦都要寫上
- 自閉合標籤不要加上結束標籤
- 自定義標籤的名字必須包含一個破折號（-），
<x-tags>、<my-element>和<my-awesome-app>都是正確的名字，而<tabs>和<foo_bar>是不正確的。這樣的限制使得 HTML 解析器能夠分辨那些是標準元素，哪些是自定義元素 - 自定義標籤必須寫上開始標籤和閉合標籤
- 儘可能減小標籤數量
元素屬性
- 元素屬性值使用雙引號語法
推薦：
<input type="text">
複製代碼
不推薦：
<input type=text>
<input type='text'>
複製代碼
代碼嵌套
- 塊元素能夠包含內聯元素或某些塊元素，但內聯元素卻不能包含塊元素，它只能包含其它的內聯元素
- 標題和段落中不能包含塊，如：h一、h二、h三、h四、h五、h六、p、dt
- 塊與內聯不能並列，塊級元素與塊級元素並列、內嵌元素與內嵌元素並列
- 有些標籤是固定的嵌套規則，好比 ul 包含 li、ol 包含 li、dl 包含 dt 和 dd 等等。
靈活使用僞類
不要讓非內容信息污染了你的 HTML，打亂了 HTML 結構。能夠使用:before、:after 等僞類元素
推薦：
HTML 代碼
<!-- That is clean markup! -->
<span class="text-box">
See the square next to me?
</span>
複製代碼
CSS 代碼：
/* We use a :before pseudo element to solve the design problem of placing a colored square in front of the text content */
.text-box:before {
content: '';
display: inline-block;
width: 1rem;
height: 1rem;
background-color: red;
}
複製代碼
不推薦：
HTML 代碼：
<!-- We should not introduce an additional element just to solve a design problem -->
<span class="text-box">
<span class="square"></span>
See the square next to me?
</span>
複製代碼
CSS 代碼：
.text-box > .square {
display: inline-block;
width: 1rem;
height: 1rem;
background-color: red;
}
複製代碼
特殊符號必須使用轉義符
| 符號 | 描述 | 轉義符 |
|---|---|---|
| 空格 | |
|
| < | 小於 | < |
| > | 大於 | > |
| & | 和 | & |
| " | 引號 | " |
純數字輸入框
使用 type="tel" 而不是 type="number"
<input type="tel">
複製代碼
類型屬性
不須要爲 CSS、JS 指定類型屬性，HTML5 中默認已包含。
推薦：
<link rel="stylesheet" href="" >
<script src=""></script>
複製代碼
不推薦：
<link rel="stylesheet" type="text/css" href="" >
<script type="text/javascript" src="" ></script>
複製代碼
註釋規範
單行註釋
- 通常用於簡單的描述，如某些狀態描述、屬性描述等
- 註釋內容先後各一個空格字符，註釋位於要註釋代碼的上面，單獨佔一行
推薦：
<!-- Comment Text -->
<div>...</div>
複製代碼
不推薦：
<div>...</div><!-- Comment Text -->
<div><!-- Comment Text -->
...
</div>
複製代碼
模塊註釋
- 註釋內容先後各一個空格字符
<!-- S Comment Text -->表示模塊開始<!-- E Comment Text -->表示模塊結束，模塊與模塊之間相隔一行- 模塊註釋內部嵌套模塊註釋，
<!-- /Comment Text -->
推薦：
<!-- S Comment Text A -->
<div class="mod_a">
<div class="mod_b">
...
</div>
<!-- /mod_b -->
<div class="mod_c">
...
</div>
<!-- /mod_c -->
</div>
<!-- E Comment Text A -->
<!-- S Comment Text D -->
<div class="mod_d">
...
</div>
<!-- E Comment Text D -->
複製代碼
語義化
- 沒有 CSS 的 HTML 是一個語義系統而不是 UI 系統
- 一般狀況下，每一個標籤都是有語義的
- 語義化的 HTML 結構，有助於機器（搜索引擎）理解，另外一方面多人協做時，能迅速瞭解開發者意圖
- 建議頁面中多使用語義化標籤，而不是整個頁面以 div 構成
常見標籤語義：
| 標籤 | 語義 |
|---|---|
<p> |
段落 |
<hn> |
標題(h1~h6) |
<ul> |
無序列表 |
<ol> |
有序列表 |
<nav> |
標記導航，僅對文檔中重要的連接羣使用 |
<main> |
頁面主要內容，一個頁面只能使用一次。若是是 web 應用，則包圍其主要功能 |
<article> |
定義外部的內容，其中的內容獨立於文檔的其他部分 |
<section> |
定義文檔中的節（section、區段）。好比章節、頁眉、頁腳或文檔中的其餘部分。 |
<aside> |
定義其所處內容以外的內容。如側欄、文章的一組連接、廣告、友情連接、相關產品列表 |
<header> |
頁眉一般包括網站標誌、主導航、全站連接以及搜索框 |
<footer> |
頁腳，只有當父級是 body 時，纔是整個頁面的頁腳 |
<figure> |
規定獨立的流內容（圖像、圖表、照片、代碼等等）（默認有 40px 左右 margin） |
相關文章
- 1. 前端規範1-HTML規範
- 2. 前端開發規範：命名規範、HTML 規範、CSS 規範、JavaScript 規範
- 3. 前端開發規範：命名規範、html規範、css規範、js規範
- 4. web前端開發規範：命名規範、html規範、css規範、js規範
- 5. 前端開發規範：命名規範、html 規範、css 規範、js 規範
- 6. 【規範】前端編碼規範——html 規範
- 7. 前端規範之CSS規範
- 8. 前端規範之javascript規範
- 9. 前端規範之vue 項目規範
- 10. 前端規範之nodeJs 規範
- 更多相關文章...
- • RDF 規則 - RDF 教程
- • XML 語法規則 - XML 教程
- • 使用阿里雲OSS+CDN部署前端頁面與加速靜態資源
- • Docker容器實戰(一) - 封神Server端技術
相關標籤/搜索
每日一句
-
每一个你不满意的现在，都有一个你没有努力的曾经。
歡迎關注本站公眾號,獲取更多信息
