HTML5 制訂至今,語意化標籤一直是團隊學習與實戰中最容易出錯的一環。標籤本身的語意定義寫在規範裡,看似清楚,但真正落實到版面時,很多人會不自覺地把新標籤當成舊標籤的替代品,於是產生了大量「看起來很先進、實際上沒有意義」的標記。
本文整理自 html5doctor 上的一篇經典文章(作者 Richard Clark,原文標題《Avoiding common HTML5 mistakes》),把最常見的幾類錯誤與不良實踐逐條拆解,並附上修正前後的對照寫法。
最常見的錯誤,就是看到 <div> 就想換成 <section>,尤其是那個負責包住整頁的外層容器。過去的寫法通常是這樣:
<!-- HTML 4 風格的寫法 -->
<div id="wrapper">
<div id="header">
<h1>My super duper page</h1>
</div>
<div id="main">...</div>
<div id="secondary">...</div>
<div id="footer">...</div>
</div>
而很多人的「升級版」長成這樣:
<!-- 請勿照抄,這是錯的 --> <section id="wrapper"> <header><h1>My super duper page</h1></header> <section id="main">...</section> <section id="secondary">...</section> <footer>...</footer> </section>
問題很明顯:<section> 並不是一個容器。它是具備語意的一「段」內容,用來參與文件大綱的建構,而且應該帶有標題。如果你只是想找一個元素來掛樣式,最直接的作法其實是對 <body> 下樣式;若確實需要額外的包裹層,那就老實用 <div>。<div> 並沒有被廢除,在沒有更合適的語意標籤時,它就是最合適的選擇。
依這個原則修正後:
<body>
<header>
<h1>My super duper page</h1>
</header>
<div role="main">...</div>
<aside role="complementary">...</aside>
<footer>...</footer>
</body>
是否需要多一層 <div>,取決於你的設計。真的拿不準主意時,可以參考 HTML5 sectioning content 的判斷流程圖。
寫下不需要的標籤,本身就是一種負債。<header> 與 <hgroup> 是最常被濫用的兩個:
一份文件裡可以出現多個 <header>,但下面這種寫法是多餘的:
<!-- 這裡根本不需要 header -->
<article>
<header>
<h1>My best blog post</h1>
</header>
...
</article>
如果 <header> 裡只有一個標題元素,就直接寫標題就好。<article> 本身已經足以讓標題出現在文件大綱中,而 <header> 又沒有承載多重內容,多包一層毫無收益:
<article> <h1>My best blog post</h1> ... </article>
有兩種情況不該同時出現 <header> 與 <hgroup>:一是只有單一標題;二是 <hgroup> 本身就足夠。
第一種:
<!-- 不需要 hgroup -->
<header>
<hgroup>
<h1>My best blog post</h1>
</hgroup>
<p>by Rich Clark</p>
</header>
移除 <hgroup> 即可:
<header> <h1>My best blog post</h1> <p>by Rich Clark</p> </header>
第二種:
<!-- 不需要 header -->
<header>
<hgroup>
<h1>My company</h1>
<h2>Established 1893</h2>
</hgroup>
</header>
當 <header> 的子元素只有 <hgroup>、沒有其他兄弟元素時,這一層 <header> 就沒有存在意義:
<hgroup> <h1>My company</h1> <h2>Established 1893</h2> </hgroup>
HTML5 新增了大量元素,選擇變多,濫用的機會也跟著變多,<nav> 就是最典型的例子。規範原文說得很清楚:
The nav element represents a section of a page that links to other pages or to parts within the page: a section with navigation links.
Note: Not all groups of links on a page need to be in a nav element — the element is primarily intended for sections that consist of major navigation blocks. In particular, it is common for footers to have a short list of links to various pages of a site, such as the terms of service, the home page, and a copyright page. The footer element alone is sufficient for such cases; while a nav element can be used in such cases, it is usually unnecessary. — WHATWG HTML spec
關鍵詞是「主要」導航。筆者的判斷標準包含:主選單、搜尋、二級導航(這一項有爭議)、長篇文章的頁內目錄。而以下情況則不建議使用 <nav>:
猶豫不決時,可以問自己兩個問題:這是不是主要連結?如果用 <section> 加上標題就能解決,是不是根本不需要 <nav>(Hixie on IRC 的建議)?這是不是為了無障礙而加的跳轉連結?若答案都是否定的,那就不該用 <nav>。
常見的過度標記:整站每一張圖片都被 <figure> 包住。這不會帶來任何好處,只會讓程式碼更長、內容更難讀。
規範的定義是:「某些流內容,可以有標題,自我包含並且通常作為一個單元獨立於主文件流之外。」重點在於它必須能被抽離——移到邊欄或附錄,而完全不影響主文的閱讀。
如果只是一張裝飾性圖片,與上下文沒有關聯,就不需要 <figure>。用兩個問題檢驗:「這張圖需要對上下文做出說明嗎?」「我能把它移到附錄裡嗎?」兩題皆為「是」,才該用 <figure>;若只是補充說明而不屬於圖形內容,<aside> 可能更合適。
<!-- 請勿照抄,這是錯的 -->
<header>
<h1>
<figure>
<img src="/img/mylogo.png" alt="My company" class="hide" />
</figure>
My company name
</h1>
</header>
<!-- 請勿照抄,這也是錯的 -->
<header>
<figure>
<img src="/img/mylogo.png" alt="My company" />
</figure>
</header>
Logo 幾乎不會處於「需要上下文說明」或「可被 <section> 包裹」的情境,因此不需要 <figure>:
<header> <h1>My company name</h1> <!-- 其他內容 --> </header>
另一個常見誤解是認為 <figure> 只能包圖片。事實上它可以用在 <video>、<audio>、圖表(例如 SVG)、引言、表格、一段程式碼、一段詩文,或這些元素的任意組合。我們的工作是用標籤更精準地描述內容,沒必要把 <figure> 侷限在 <img> 上。
這算不上錯誤,但絕對是該避免的不良實踐。HTML5 中 <link> 與 <script> 都不需要 type:
<!-- 屬性堆疊,多餘 --> <link type="text/css" rel="stylesheet" href="css/styles.css" /> <script type="text/javascript" src="js/scripts.js"></script>
因為所有瀏覽器都會把 <script> 當成 JavaScript、把 <link rel="stylesheet"> 當成 CSS,直接寫成這樣即可:
<link rel="stylesheet" href="css/styles.css" /> <script src="js/scripts.js"></script>
編碼宣告也可以一併省略,Mark Pilgrim 在《Dive into HTML5》的語意化章節有詳細說明。若你的 CMS 會自動插入這些屬性,清除成本太高,那至少在手寫程式碼或完全掌控模板時把它們拿掉。
HTML5 新增了幾個布林型屬性,包括 autofocus、autocomplete 與 required。它們的行為是「只要屬性存在就成立」,因此下面這些寫法都有問題:
<!-- 錯 --> <input type="email" name="email" required="true" /> <input type="email" name="email" required="1" />
看起來無害,但當有人改成 required="false" 時,麻煩就來了:
<!-- 錯:瀏覽器依然視為必填 --> <input type="email" name="email" required="false" />
解析器只會判斷 required 這個屬性是否存在,你寫 false 它照樣當成 true。正確的寫法是只寫屬性名稱:
<input type="email" name="email" required />
(若你必須輸出 XHTML 格式的文件,才需要寫成 required="required"。)
糟糕的標記模式遠不止這幾種,但以上這些是實際專案裡最常出現的。語意化標籤的價值不在於「看起來新」,而在於它是否真的描述了內容的結構。寫之前多想一秒:這個標籤,真的需要嗎?