標籤。自關閉元素(如 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> 之下。嚴格嵌套約束:
<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>。
文檔類型。每個 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 模板:
<!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>
為區塊加上說明,能大幅降低協作成本。
<!-- 文章列表模組 --> <div class="article-list"> ... </div>
較完整的區塊註解可以帶上名稱、說明與作者:
<!-- @name: Drop Down Menu @description: Style of top bar drop down menu. @author: Ashu (Aaaaaashu@gmail.com) -->