DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> HTML基礎知識 >> HTML和Xhtml
HTML 程式碼撰寫規範指南:從標籤到 head 模板
編輯:HTML和Xhtml     

通用約定

標籤。自關閉元素(如 img、input、br、hr)不需要另外寫結束標籤;可選的結束標籤(如 </li>、</body>)則建議補上;並盡量減少標籤數量。

<img src="images/google.png" alt="Google">
<input type="text" name="title">

<ul>
  <li>Style</li>
  <li>Guide</li>
</ul>

<!-- 不建議 -->
<span class="avatar">
  <img src="...">
</span>

<!-- 建議 -->
<img class="avatar" src="...">

Class 與 ID。class 應以功能或內容命名,而非以外觀命名(叫 .red-text 不如叫 .warning-text);class 與 id 一律小寫,多單字時用中劃線分隔;用唯一的 id 作為 JavaScript 掛載點,同時避免產生沒有樣式意義的空 class。

<!-- 不建議 -->
<div class="j-hook left contentWrapper"></div>

<!-- 建議 -->
<div id="j-hook" class="sidebar content-wrapper"></div>

屬性順序。為了可讀性,HTML 屬性建議依固定順序排列:

id
class
name
data-xxx
src, for, type, href
title, alt
aria-xxx, role
<a id="..." class="..." data-modal="toggle" href="###"></a>

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

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

引號。屬性值統一使用雙引號。

<!-- 不建議 -->
<span id='j-hook' class=text>Google</span>

<!-- 建議 -->
<span id="j-hook" class="text">Google</span>

嵌套約束

嵌套限制可分兩類。嚴格嵌套約束在所有瀏覽器下都不被允許;語意嵌套約束則多數瀏覽器會容錯處理,但各自生成的 DOM 樹可能不一致——這正是跨瀏覽器差異的常見來源。

語意嵌套約束:

  • <li> 應用於 <ul> 或 <ol> 之下。
  • <dd>、<dt> 應用於 <dl> 之下。
  • <thead>、<tbody>、<tfoot>、<tr>、<td> 應用於 <table> 之下。

嚴格嵌套約束:

  • 行內(inline-level)元素只能包含文字或其他行內元素。
  • <a> 內不可再嵌套互動元素,如 <a>、<button>、<select>。
  • <p> 內不可嵌套區塊元素,如 <div>、<h1>~<h6>、<p>、<ul>/<ol>/<li>、<dl>/<dt>/<dd>、<form>。

布林屬性。HTML5 規範中,disabled、checked、selected 這類屬性不需要設定值,寫上即代表成立。

<input type="text" disabled>

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

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

語意化

拿掉 CSS 之後,HTML 呈現的是一套語意系統,而不是 UI 系統。每個標籤都有它對應的角色與含義——就像衣服分外套、褲子、裙子、內衣,各有功能,你不會把內衣套在脖子上。

語意化的結構有兩個實際好處:一是機器(尤其搜尋引擎)更容易理解內容;二是多人協作時,同事能迅速讀懂你的意圖。

常見標籤的語意對照:

  • <p> 段落;<h1>~<h6> 標題。
  • <ul> 無序清單;<ol> 有序清單。
  • <blockquote> 大段引用;<cite> 一般引用。
  • <b> 為樣式而加粗;<strong> 為強調而加粗。
  • <i> 為樣式而傾斜;<em> 為強調而傾斜。
  • <code> 程式碼標識;<abbr> 縮寫。

一個實用的類比:把頁面當成一本書。書名用 <h1>,章節標題用 <h2>,章內文章標題用 <h3>,小標與副標題用 <h4>~<h6>,段落則一律用 <p>。

HEAD 區段規範

文檔類型。每個 HTML 檔案的第一行都必須是標準模式聲明,才能確保各瀏覽器表現一致:

<!DOCTYPE html>

語言屬性。依內容語言標註,這對螢幕閱讀器與搜尋引擎都有意義:

<!-- 中文 -->
<html lang="zh-Hans">

<!-- 簡體中文 -->
<html lang="zh-cmn-Hans">

<!-- 繁體中文 -->
<html lang="zh-cmn-Hant">

<!-- English -->
<html lang="en">

字元編碼。檔案以不帶 BOM 的 UTF-8 儲存;指定編碼的 meta 必須是 <head> 的第一個直接子元素:

<html>
  <head>
    <meta charset="utf-8">
    ......
  </head>
  <body>
    ......
  </body>
</html>

IE 相容模式。優先讓瀏覽器使用最新版本的 IE 與 Chrome 核心:

<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">

SEO 相關標籤。標題、關鍵字、描述與作者一併齊備:

<head>
  <meta charset="utf-8">
  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
  <!-- SEO -->
  <title>Style Guide</title>
  <meta name="keywords" content="your keywords">
  <meta name="description" content="your description">
  <meta name="author" content="author, email address">
</head>

viewport。viewport 指瀏覽器視窗的內容區大小,不包含工具列與分頁;width 是輸出裝置上頁面可見區域的寬度;device-width 是裝置解析度寬度;initial-scale 與 maximum-scale 則分別對應初始與最大縮放比例。為行動裝置優化時,務必設定可見區域寬度與初始縮放:

<meta name="viewport" content="width=device-width, initial-scale=1.0">

iOS 圖示。apple-touch-icon 會被系統自動套用圓角與高光;加上 -precomposed 則保留設計原圖,禁止系統加工:

<!-- iPhone 和 iTouch,預設 57x57 像素,必須有 -->
<link rel="apple-touch-icon-precomposed" href="/apple-touch-icon-57x57-precomposed.png">

<!-- iPad,72x72 像素,可選但建議有 -->
<link rel="apple-touch-icon-precomposed" href="/apple-touch-icon-72x72-precomposed.png" sizes="72x72">

<!-- Retina iPhone / iTouch,114x114 像素 -->
<link rel="apple-touch-icon-precomposed" href="/apple-touch-icon-114x114-precomposed.png" sizes="114x114">

<!-- Retina iPad,144x144 像素 -->
<link rel="apple-touch-icon-precomposed" href="/apple-touch-icon-144x144-precomposed.png" sizes="144x144">

favicon。未指定時,多數瀏覽器會自動向伺服器根目錄請求 favicon.ico。為了避免 404,請二選一:把 favicon.ico 放在網站根目錄,或用 link 明確指定:

<link rel="shortcut icon" href="path/to/favicon.ico">

HEAD 模板

把上面這些規則整合起來,就是一份可以直接複用的 head 模板:

<!DOCTYPE html>
<html lang="zh-cmn-Hans">
<head>
  <meta charset="utf-8">
  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
  <title>Style Guide</title>
  <meta name="description" content="不超過 150 個字元">
  <meta name="keywords" content="">
  <meta name="author" content="name, email@gmail.com">

  <!-- 為行動裝置添加 viewport -->
  <meta name="viewport" content="width=device-width, initial-scale=1.0">

  <!-- iOS 圖示 -->
  <link rel="apple-touch-icon-precomposed" href="/apple-touch-icon-57x57-precomposed.png">

  <link rel="alternate" type="application/rss+xml" title="RSS" href="/rss.xml" />
  <link rel="shortcut icon" href="path/to/favicon.ico">
</head>

HTML 註解

為區塊加上說明,能大幅降低協作成本。

<!-- 文章列表模組 -->
<div class="article-list">
...
</div>

較完整的區塊註解可以帶上名稱、說明與作者:

<!--
@name: Drop Down Menu
@description: Style of top bar drop down menu.
@author: Ashu (Aaaaaashu@gmail.com)
-->
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved