前端入門不難,學會基本的 HTML 與 CSS 就能在瀏覽器上看到成果;但要寫出「好」的 HTML,門檻就高多了。以下從三個層面談談實務上值得遵守的 HTML 規範。
(1)文件必須以 <!DOCTYPE> 作為首行、頂格書寫,讓瀏覽器知道這是哪一種文件,建議直接使用 <!DOCTYPE html>。
(2)必須在 head 內以 meta 標籤宣告字元編碼,例如 <meta charset="UTF-8">。少了這行,中文頁面極可能出現亂碼。
(3)頁面的 title 不可省略,它同時影響辨識度與 SEO。
在 Sublime Text 中輸入 ! 再按 Tab,即可得到基礎骨架:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Document</title>
</head>
<body>
</body>
</html>
(1)依「由上而下、由左而右」的視覺順序撰寫結構,讀者與維護者都更輕鬆。
(2)為了搜尋引擎抓取,可以把重要內容在原始碼順序上提前。爬蟲大致是自上而下解析的,重要內容放前面有助於被抓到。
(3)不要再用 table 做版面配置,那是已被淘汰的做法;改用 div 搭配 CSS,控制力更強也更容易維護。
(1)用 <link> 在 head 中引入外部 CSS。一般不建议使用 @import 引入樣式表,因為它會多一層請求、且載入時序較不利於效能。
(2)用 <script> 引入 JS 並放在 body 尾端,讓 HTML 先完成繪製、腳本最後載入,使用者體驗更好。並非所有腳本都適合放底部——例如需要動態改寫 meta 的 flexible.js,就必須放進 head。
(1)每個塊級元素獨立一行,用 Tab 縮排對齊。慣例是 html、head、body 以及 body 的直接子元素不縮排,其餘正常縮排。

(2)可以在大模組之間空一行分隔,但模組內部不要塞入多餘空行。
(1)單一標籤上的 class 名稱不宜過多,越少越好。
(2)對於本身已具語義的內部標籤,盡量不要再額外掛 class。
<!-- 開始:註解文案 --> <!-- 結束:/註解文案 -->
只有起始註解也是允許的寫法。

(1)以最嚴格的 XHTML Strict 精神來嵌套,例如行內元素不應包住塊級元素。
(2)標籤必須正確閉合,且不可省略閉合。
(1)屬性名稱與值一律小寫,每個屬性都要有值,每個值都要用雙引號包覆。
(2)沒有實際值的屬性,用自己的名稱作為值,例如 checked="checked"、disabled="disabled"、readonly="readonly"、selected="selected"。
(3>style 與 script 標籤的 type 屬性可以省略。
例如為 img 加上完整的 alt 描述,在 audio、video 內提供文字說明與下載連結。
以背景圖片呈現的文字,應該同時寫進 HTML,再用 CSS 把它移出視覺範圍。這樣做有兩個好處:搜尋引擎能抓到內容,CSS 失效時使用者也仍看得到資訊。
以實體取代與 HTML 語法衝突的字元,可避免瀏覽器解析錯誤。常用的建議使用實體如下圖。

而以下這類字元,通常不需要特別轉成實體:

總結來說,好的 HTML 不是「瀏覽器能跑就好」,而是結構清楚、語義正確、易於長期維護。這些習慣在專案規模變大後,價值會被急遽放大。