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)化，這樣搜索引擎才更喜歡。

性定義及使用說(shuō)明

width屬性設(shè)置元素的寬度。

注意： width屬性不包括填充，邊框和頁(yè)邊距！

默認(rèn)值： auto
繼承： no
版本： CSS1
JavaScript 語(yǔ)法：object.style.width="50px"

屬性值

值 描述
auto 默認(rèn)值。瀏覽器可計(jì)算出實(shí)際的寬度。
length 使用 px、cm 等單位定義寬度。
% 定義基于包含塊（父元素）寬度的百分比寬度。
inherit 規(guī)定應(yīng)該從父元素繼承 width 屬性的值。

實(shí)例

百分比：

.p img{width:100%}

百分比平分，將三個(gè)<li>平均分配

width：calc( 100% / n - ?px)

注：n 平分幾份除以幾；？px 為一個(gè)標(biāo)簽的外表距（也可用百分比）

實(shí)際效果

最大寬度：max-width

最小寬度：min-width

例

設(shè)置輪廓的寬度：

p{outline-style:dotted; outline-width:5px;}

屬性定義及使用說(shuō)明

outline（輪廓）是繪制于元素周?chē)囊粭l線，位于邊框邊緣的外圍。

outline-width指定輪廓的寬度。

注意： 請(qǐng)始終在outline-width屬性之前聲明outline-style屬性。元素只有獲得輪廓以后才能改變其輪廓的寬度。

默認(rèn)值：	medium
繼承：	no
版本：	CSS2
JavaScript 語(yǔ)法：	object.style.outlineWidth="thin"

瀏覽器支持

表格中的數(shù)字表示支持該屬性的第一個(gè)瀏覽器版本號(hào)。

屬性
outline-width	1.0	8.0	1.5	1.2	7.0

提示和注釋

outline是圍繞元素。它是圍繞元素的邊距。但是，它是來(lái)自不同的邊框?qū)傩浴?/p>

outline不是元素尺寸的一部分，因此元素的寬度和高度屬性不包含輪廓的寬度。

屬性值

值	描述
thin	規(guī)定細(xì)輪廓。
medium	默認(rèn)。規(guī)定中等的輪廓。
thick	規(guī)定粗的輪廓。
length	允許您規(guī)定輪廓粗細(xì)的值。
inherit	規(guī)定應(yīng)該從父元素繼承輪廓寬度的設(shè)置。

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

在線咨詢

上一篇：程序員必備知識(shí)干貨：Excel文件轉(zhuǎn)成html頁(yè)面代碼
下一篇：CSS 中幾種最常用的水平垂直居中的方法

您的項(xiàng)目需求

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

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