HTML編碼規(guī)范

版規(guī)則

縮進(jìn)

使用2個(gè)空格縮進(jìn)

<ul>
  <li>Fantastic</li>
  <li>Great</li>
</ul>

.example {
  color: blue;
}

大小寫(xiě)

只允許使用小寫(xiě)。

所有的代碼都用小寫(xiě)字母：適用于元素名，屬性，屬性值（除了文本和CDATA），選擇器，特性，特性值（除了字符串）。

<!-- 不推薦 -->
<A HREF="/">Home</A>

<!-- 推薦 -->
<img src="google.png"
alt="Google">

行為空格

建議刪除行尾白空格。

<!-- 不推薦 -->
<p>What?  </p>

<!-- 推薦 -->
<p>Yes please.</p>

常規(guī)Meta規(guī)則

編碼

如果沒(méi)有特殊需求，一般采用utf-8編碼。如果是cms站點(diǎn)，則遵守該站點(diǎn)的編碼規(guī)則。

<!-- 網(wǎng)頁(yè)編碼 -->
<meta charset="utf-8">

注釋

盡可能的去解釋你寫(xiě)的代碼。說(shuō)明該代碼包括什么、目的是什么、能做什么、為什么使用它等。

注釋是否需要詳盡，取決于項(xiàng)目的復(fù)雜程度。

一般單行注釋：

<!-- col -->

模塊間注釋：

<!-- news -->
<div class="news">
  <h2>News</h2>
  <p>...</p>
</div>
<!--/ news -->

循環(huán)注釋：

<ul>
  <!-- loop: new list -->
  <li>new's title 1</li>
  <li>new's title 2</li>
  <li>new's title 3</li>
  <li>new's title 4</li>
  <li>new's title 5</li>
  <!-- /loop: new list -->
</ul>

cms輸出注釋：

<!-- cms: news list -->
<ul>
  <li>new's title 1</li>
  <li>new's title 2</li>
  <li>new's title 3</li>
  <li>new's title 4</li>
  <li>new's title 5</li>
</ul>
<!-- /cms: news list -->

Tab選項(xiàng)卡內(nèi)容注釋：

<!-- tab: news list -->
<div class="tab"></div>
<!-- /tab: news list -->

常規(guī)HTML設(shè)計(jì)規(guī)則

文檔類型

使用html5文檔聲明，不再使用XHTML（application/xhtml+xml）。

HTML5是目前所有HTML文檔類型中的首選：

<!DOCTYPE html>

HTML 的正確性

編寫(xiě)有效、正確的HTML代碼，否則很難達(dá)到性能上的提升。

可以使用一些工具驗(yàn)證你的代碼，如 W3C HTML validator

HTML 的語(yǔ)義性

根據(jù)HTML各個(gè)元素的用途而去使用它們。

<!-- 不推薦 -->
<div class="col">
  <div class="title">
news</div>
  <p>list1</p>
  <p>list2</p>
  <p>list3</p>
</div>

<!-- 推薦 -->
<div class="col">
  <h2 class="title">
news</h2>
  <p>list1</p>
  <p>list2</p>
  <p>list3</p>
</div>

部分標(biāo)簽說(shuō)明：

div 主要用于布局，分割頁(yè)面的結(jié)構(gòu);
ul/ol 主要用于無(wú)序/有序列表;
dl/dt/dd 當(dāng)頁(yè)面中出現(xiàn)第一行為類似標(biāo)題/簡(jiǎn)述，然后下面為詳細(xì)描述的內(nèi)容時(shí)應(yīng)該使用該標(biāo)簽;
span 沒(méi)有特殊的意義，可以用作排版的輔助，然后在css中定義span;
h1-h6 標(biāo)題, 根據(jù)重要性依次遞減;
h1 最重要的標(biāo)題;
label 使表單更有親和力而且能輔助表單排版;

不推薦使用的標(biāo)簽：

font 文字的外觀，大小和顏色;
u 文本下劃線;
center 居中對(duì)齊;
s 刪除線;
strike 刪除線;
noframes 無(wú)視框時(shí)的內(nèi)容;
iframe 定義嵌入視圖;
isindex 不建議使用（可搜尋，使用input代替）;
dir 目錄式列舉;
menu 菜單列表;
basefont 定義基本字體;
applet 定義java程序;
frame 定義個(gè)別視框;
frameset 視框格式總定義;

多媒體元素降級(jí)處理

給多媒體元素，比如canvas、videos、 images增加alt屬性，提高可用性（特別是常用的img標(biāo)簽，盡可量得加上alt屬性，提供圖片的描述信息）。

<!-- 不推薦 -->
<img src="world.jpg">

<!-- 推薦 -->
<img src="world.jpg"
alt="our world images">

type屬性

在樣式表和腳本的標(biāo)簽中忽略type屬性。

HTML5默認(rèn)type為text/css和text/javascript類型，所以沒(méi)必要指定。即便是老瀏覽器也是支持的。

<!-- 不推薦 -->
<link rel="stylesheet"
 href="//www.google.com/css/maia.css"
 type="text/css">
<script src="
 //www.google.com/
 js/gweb/analytics/autotrack.js"
 type="text/javascript">
 </script>

<!-- 推薦 -->
<link rel="stylesheet"
 href="//www.google.com/css/maia.css">
<script src="
 //www.google.com/
 js/gweb/analytics/autotrack.js">
 </script>

HTML代碼格式規(guī)則

每個(gè)塊元素、列表元素或表格元素都獨(dú)占一行，每個(gè)子元素都相對(duì)于父元素進(jìn)行縮進(jìn)。按設(shè)計(jì)稿劃分模塊，盡量使頁(yè)面模塊化，模塊與模塊之前要有清晰的注釋。

如上面頁(yè)面框架，推薦寫(xiě)法：

<!-- hader -->
<div class="header">header</div>
<!-- /hader -->
<!-- nav -->
<div class="nav">nav</div>
<!-- /nav -->
<!-- main -->
<div class="main">
  <!-- container -->
  <div class="container">
    <!--news-->
    <div class="news">
      <h2>news<h2>
      <p>...</p>
    </div>
    <!--news-->
  </div>
  <!--/container-->
  <!--sidebar-->
  <div class="sidebar">
sidebar</div>
  <!--sidebar-->
</div>
<!--/main-->
<!--footer-->
<div class="footer">
footer</div>
<!--/footer-->

HTML與SEO

頁(yè)面良好層次

保證整個(gè)頁(yè)面在未加載樣式表時(shí)仍有較好的層次清晰的頁(yè)面結(jié)構(gòu)。

<!-- 不推薦 -->
<div class="logo">My Site</div>
<div class="nav">
  <a href="#">Home</a>
  <a href="#">News</a>
  <a href="#">Mobile</a>
</div>
<div class="news">
  <div>News</div>
  <a href="#">
news list 1</a>
  <a href="#">
news list 2</a>
  <a href="#">
news list 3</a>
</div>

<!-- 推薦 -->
<h1 class="logo">My Site</h1>
<ul class="nav">
  <li><a href="#">
Home</a></li>
  <li><a href="#">
News</a></li>
  <li><a href="#">
Mobile</a></li>
</ul>
<div class="news">
  <h2>News</h2>
  <ul>
    <li><a href="#">
news list 1</a>
</li>
    <li><a href="#">
news list 2</a>
</li>
    <li><a href="#">
news list 3</a>
</li>
  </ul>
</div>

權(quán)重標(biāo)簽使用

H標(biāo)簽使用

h1 權(quán)重高，體現(xiàn)當(dāng)前網(wǎng)頁(yè)中相對(duì)比較重要的信息，但不宜過(guò)多，建議一個(gè)頁(yè)面只放一個(gè);
h2 可以做副標(biāo)題;
h3 可以做新聞列表;
h4-h6 可做相關(guān)新聞的列表標(biāo)簽屬性完整;

strong、b使用

將需要加粗的文字使用b標(biāo)簽來(lái)顯示。

將需要強(qiáng)調(diào)的文字（主要指包含關(guān)鍵詞的信息）使用strong標(biāo)簽來(lái)強(qiáng)調(diào)主要內(nèi)容。

注：b是粗體標(biāo)簽，屬于實(shí)體標(biāo)簽，它所包圍的字符將被設(shè)為bold（粗體）；strong 是加重語(yǔ)氣標(biāo)簽，屬于邏輯標(biāo)簽，它的作用是加強(qiáng)字符語(yǔ)氣。

標(biāo)簽屬性使用

在很多情況下，a都要使用title來(lái)說(shuō)明該鏈接的相關(guān)說(shuō)明或目的意義。

例如：當(dāng)使用overflow隱藏掉a中的溢出文字時(shí)，該a中的title是必不可少的，它可以告訴用戶被隱藏掉的文字內(nèi)容是什么；又或者當(dāng)一個(gè)圖片型鏈接出現(xiàn)時(shí)，該a中的title同樣是必不可少的，它可以告訴用戶這個(gè)圖片鏈接是做什么用的。

注：僅在img里添加alt標(biāo)簽在火狐提示文字是出不來(lái)的，alt是圖片加載失敗或未加載完全時(shí)顯示出來(lái)的提示文字，要想鼠標(biāo)移上去顯示提示信息應(yīng)該用title，嚴(yán)謹(jǐn)?shù)膶?xiě)法是img里加入alt和title這兩個(gè)標(biāo)簽。

精簡(jiǎn)代碼

代碼保持精簡(jiǎn)，最優(yōu)化，這樣搜索引擎才更喜歡。

TML 符號(hào)實(shí)體

HTML 符號(hào)是不呈現(xiàn)在標(biāo)準(zhǔn)的鍵盤上，比如數(shù)學(xué)運(yùn)算符、箭頭符號(hào)、技術(shù)符號(hào)和形狀。

如需向 HTML 頁(yè)面添加這些符號(hào)，您可以使用 HTML 實(shí)體名稱。

如果不存在實(shí)體名稱，您可以使用實(shí)體編號(hào)。

如果字符沒(méi)有實(shí)體名稱，您可以使用十進(jìn)制（或十六進(jìn)制）引用。

實(shí)例

結(jié)果如下：

我將顯示 €

HTML 支持的數(shù)學(xué)符號(hào)

如果您使用的是一個(gè) HTML 實(shí)體名稱或一個(gè)十六進(jìn)制編號(hào)，字符總是能正確顯示。

這是與您頁(yè)面使用的字符集相互獨(dú)立的！

字符	編號(hào)	實(shí)體	描述
?	∀	∀	所有（for all）
?	∂	∂	部分（part）
?	∃	∃	存在（exists）
?	∅	∅	空（empty）
?	∇	∇	倒三角（nabla）
∈	∈	∈	屬于（isin）
?	∉	∉	不屬于（notin）
?	∋	&ni;	包含的成員（ni）
∏	∏	∏	連乘（prod）
∑	∑	∑	總和（sum）

完整的數(shù)學(xué)（Math）參考手冊(cè)

HTML 支持的希臘字母

字符	編號(hào)	實(shí)體	描述
Α	Α	Α	Alpha（中文注音：阿耳法）
Β	Β	Β	Beta（中文注音：貝塔）
Γ	Γ	Γ	Gamma（中文注音：伽馬）
Δ	Δ	Δ	Delta（中文注音：德耳塔）
Ε	Ε	Ε	Epsilon（中文注音：艾普西隆）
Ζ	Ζ	Ζ	Zeta（中文注音：截塔）

完整的希臘（Greek）參考手冊(cè)

HTML 支持的其他實(shí)體

字符	編號(hào)	實(shí)體	描述
?	©	©	版權(quán)所有（REGISTERED SIGN）
?	®	®	注冊(cè)商標(biāo)（REGISTERED SIGN）
€	€	€	歐元符號(hào)（EURO SIGN）
?	™	™	商標(biāo)（trademark）
←	←	←	向左箭頭（LEFTWARDS ARROW）
↑	↑	↑	向上箭頭（UPWARDS ARROW）
→	→	→	向右箭頭（RIGHTWARDS ARROW）
↓	↓	↓	向下箭頭（DOWNWARDS ARROW）
?	♠	&spades;	黑桃（BLACK SPADE SUIT）
?	♣	&clubs;	黑梅花（BLACK CLUB SUIT）
?	♥	&hearts;	黑心（BLACK HEART SUIT）
?	♦	&diams;	黑方塊（BLACK DIAMOND SUIT）

如您還有不明白的可以在下面與我留言或是與我探討QQ群308855039，我們一起飛！

法

縮進(jìn)使用soft tab（4個(gè)空格）；
嵌套的節(jié)點(diǎn)應(yīng)該縮進(jìn)；
在屬性上，使用雙引號(hào)，不要使用單引號(hào)；
屬性名全小寫(xiě)，用中劃線做分隔符；
不要在自動(dòng)閉合標(biāo)簽結(jié)尾處使用斜線（HTML5 規(guī)范指出他們是可選的）；
不要忽略可選的關(guān)閉標(biāo)簽，例:

<!DOCTYPE html>
 <html>
 	<head>
 		<title>Page title</title>
 	</head>
 	<body> <img src="images/company_logo.png" alt="Company">
 		<h1 class="hello-world">Hello, world!</h1>
 	</body>
 </html>

HTML5 doctype在頁(yè)面開(kāi)頭使用這個(gè)簡(jiǎn)單地doctype來(lái)啟用標(biāo)準(zhǔn)模式，使其在每個(gè)瀏覽器中盡可能一致的展現(xiàn)；雖然doctype不區(qū)分大小寫(xiě)，但是按照慣例，doctype大寫(xiě) （關(guān)于html屬性，大寫(xiě)還是小寫(xiě)）。<!DOCTYPE html> <html> ... </html> lang屬性根據(jù)HTML5規(guī)范：應(yīng)在html標(biāo)簽上加上lang屬性。這會(huì)給語(yǔ)音工具和翻譯工具幫助，告訴它們應(yīng)當(dāng)怎么去發(fā)音和翻譯。
更多關(guān)于 lang 屬性的說(shuō)明在這里；在sitepoint上可以查到語(yǔ)言列表；
但sitepoint只是給出了語(yǔ)言的大類，例如中文只給出了zh，但是沒(méi)有區(qū)分香港，臺(tái)灣，大陸。而微軟給出了一份更加詳細(xì)的語(yǔ)言列表.aspx)，其中細(xì)分了zh-cn, zh-hk, zh-tw。<!DOCTYPE html> <html lang="en-us"> ... </html> 字符編碼通過(guò)聲明一個(gè)明確的字符編碼，讓瀏覽器輕松、快速的確定適合網(wǎng)頁(yè)內(nèi)容的渲染方式，通常指定為’UTF-8’。<!DOCTYPE html> <html> <head> <meta charset="UTF-8"> </head> ... </html> IE兼容模式用 <meta> 標(biāo)簽可以指定頁(yè)面應(yīng)該用什么版本的IE來(lái)渲染；<!DOCTYPE html> <html> <head> <meta http-equiv="X-UA-Compatible" content="IE=Edge"> </head> ... </html> 引入CSS, JS根據(jù)HTML5規(guī)范, 通常在引入CSS和JS時(shí)不需要指明 type，因?yàn)?text/css 和 text/javascript 分別是他們的默認(rèn)值。HTML5 規(guī)范鏈接使用link
使用style
使用script <link rel="stylesheet" href="code_guide.css">  <style> ... </style>  <script src="code_guide.js"></script>  <script> ... </script> 屬性順序屬性應(yīng)該按照特定的順序出現(xiàn)以保證易讀性；

class
id
name
data-*
src, for, type, href, value , max-length, max, min, pattern
placeholder, title, alt
aria-*, role
required, readonly, disabled

class是為高可復(fù)用組件設(shè)計(jì)的，所以應(yīng)處在第一位；
id更加具體且應(yīng)該盡量少使用，所以將它放在第二位。

<a class="..." id="..." data-modal="toggle" href="#">Example link</a>

<input class="form-control" type="text">

<img src="..." alt="...">

boolean屬性

boolean屬性指不需要聲明取值的屬性，XHTML需要每個(gè)屬性聲明取值，但是HTML5并不需要；
更多內(nèi)容可以參考 WhatWG section on boolean attributes：
boolean屬性的存在表示取值為true，不存在則表示取值為false。

<input type="text" disabled>

<input type="checkbox" value="1" checked>

<select>
    <option value="1" selected>1</option>
</select>

JS生成標(biāo)簽

在JS文件中生成標(biāo)簽讓內(nèi)容變得更難查找，更難編輯，性能更差。應(yīng)該盡量避免這種情況的出現(xiàn)。

減少標(biāo)簽數(shù)量

在編寫(xiě)HTML代碼時(shí)，需要盡量避免多余的父節(jié)點(diǎn)；很多時(shí)候，需要通過(guò)迭代和重構(gòu)來(lái)使HTML變得更少。

<!-- Not well -->
<span class="avatar">
    <img src="...">
</span>

<!-- Better -->
<img class="avatar" src="...">

實(shí)用高于完美

盡量遵循HTML標(biāo)準(zhǔn)和語(yǔ)義，但是不應(yīng)該以浪費(fèi)實(shí)用性作為代價(jià)；任何時(shí)候都要用盡量小的復(fù)雜度和盡量少的標(biāo)簽來(lái)解決問(wèn)題。

在線咨詢

上一篇：零基礎(chǔ)學(xué)習(xí)HTML換行符段落標(biāo)題水平線文本格式化字體鏈接錨點(diǎn)
下一篇：新手必看，完整的網(wǎng)站建設(shè)制作流程

您的項(xiàng)目需求

*請(qǐng)認(rèn)真填寫(xiě)需求信息，我們會(huì)在24小時(shí)內(nèi)與您取得聯(lián)系。

整合營(yíng)銷服務(wù)商