HTML5 帶來了語意化的新元素,但也讓不少開發者在不知不覺中寫出「看似正確、實則不當」的標籤。以下整理六個最常見的錯誤示範,並附上建議的正確做法。
最常見的誤解之一,就是把 HTML5 的 <section> 直接當成 <div> 的替代品,純粹用來套用樣式。過去在 XHTML 或 HTML4 中,我們常看到這樣的結構:
<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」的寫法,其實是錯誤的示範:
<!-- 請勿照抄!這是錯誤寫法 -->
<section id="wrapper">
<header><h1>My super duper page</h1></header>
<section id="main">...</section>
<section id="secondary">...</section>
<footer>...</footer>
</section>
問題在於:<section> 並不是用來當作樣式容器(wrapper)。它代表的是內容中協助建構文件大綱的語意區段,且應該包含一個標題(heading)。如果你需要一個用來包住整頁的容器,不妨參考 Kroc Camen 的建議,直接把樣式套在 body 元素上;若確實需要額外的樣式容器,繼續使用 <div> 才是正解。
依這個思路,正確的做法可以是:
<body>
<header><h1>My super duper page</h1></header>
<div role="main">...</div>
<aside role="complementary">...</aside>
<footer>...</footer>
</body>
若仍無法判斷該用哪個元素,可以參考 HTML5 sectioning content 元素的流程圖來輔助決策。
寫下多餘的標籤毫無意義,然而 <header> 與 <hgroup> 卻經常被濫用。先釐清兩者的定位:
<header>:代表一組前言或導覽性質的輔助內容,常用於 section 的開頭。<hgroup>:當標題具備多層結構(如子標題、副標題、各種標識文字)時,用來把 h1–h6 群組為 section 的標題。由於 header 可以在文件中多次使用,容易讓人寫出如下看似合理、實則多餘的結構:
<!-- 請勿照抄!此處不需要 header -->
<article>
<header><h1>My best blog post</h1></header>
...
</article>
如果你的 <header> 只包著一個標題元素,那就乾脆拿掉它。既然 <article> 已保證標題會出現在文件大綱中,寫成這樣就夠了:
<article>
<h1>My best blog post</h1>
...
</article>
有些情況下,<hgroup> 與 <header> 並不需要同時出現——例如只有單一子標題時,或 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 裡只放了 hgroup:
<!-- 請勿照抄!此處不需要 header -->
<header>
<hgroup>
<h1>My company</h1>
<h2>Established 1893</h2>
</hgroup>
</header>
若 header 唯一的子元素就是 hgroup,那又何必多包一層?直接寫成:
<hgroup>
<h1>My company</h1>
<h2>Established 1893</h2>
</hgroup>
HTML5 引入了大批新元素,但我們不該濫用這些「超語意化」的標籤,nav 就是重災區。規範對 nav 的描述是:代表頁面上連結到其他頁面或頁面內某部分的區塊,也就是「包含導覽連結的區塊」;但並非頁面上所有連結群組都必須放進 nav——它主要服務的是「主要導覽區塊」。舉例來說,頁尾常有服務條款、首頁、版權聲明等一長串連結,這些用 <footer> 本身就足夠,硬塞 nav 通常並非必要。
關鍵字在於「主要的」。依此,以下幾類通常可視為適合放進 nav:
相對地,以下情況我通常不建議放進 <nav>:
不確定某組連結是否該放進 nav 時,捫心自問:「它是主要導覽嗎?」兩個好用的判斷原則是:如果改用 <section> 搭配標題也同樣合適,那就別用 nav;以及,你會不會在「快速跳轉」中為它補上一條連結?若答案是否定的,就果斷地跟 nav 說再見吧。
不少人把每張圖片都寫成 figure,這只是徒增負擔,並不會讓內容更清晰。規範將 <figure> 描述為「一段可獨立參照的流動內容,通常帶有說明文字」,它的美妙之處在於可以從主內容移到側邊欄而不影響文件流。若一張圖純粹為了呈現、也不會在別處被參照,那它就不是 figure。判斷時可以問自己:「這張圖是否與上下文密切相關?」「我能把它移到附錄裡嗎?」若兩者皆非,或許它根本不是 figure。
常見的錯誤寫法如下:
<!-- 請勿照抄!這是錯的 -->
<header>
<h1>
<figure>
<img src="/img/mylogo.png" alt="My company" class="hide" />
</figure>
My company name
</h1>
</header>
figure 只應被文件參照或被 section 元素圍繞,而你的 logo 大概不會以這種方式被引用。簡單寫成這樣即可:
<header>
<h1>My company name</h1>
<!-- More stuff in here -->
</header>
另一個常見誤解,是以為 figure 只能放圖片。事實上,figure 可以是影片、音訊、圖表、一段引言、表格、一段程式碼、一段散文,或它們的任意組合。別把 figure 侷限在圖片上——Web 標準的職責,正是用標籤精確描述內容。
這雖不算錯誤,但值得透過最佳實踐避免。在 HTML5 中,script 與 style 元素已不再需要 type 屬性。除非你的 CMS 會自動加上,否則沒理由保留:
<!-- 請勿照抄!太冗餘了 -->
<link type="text/css" rel="stylesheet" href="css/styles.css" />
<script type="text/javascript" src="js/scripts.js"></script>
其實只需寫成:
<link rel="stylesheet" href="css/styles.css" />
<script src="js/scripts.js"></script>
就連指定字元集的宣告都可以省略,Mark Pilgrim 在《Dive into HTML5》的語意化一章中有詳細說明。
HTML5 新增了幾個布林型的 form 屬性,只要屬性一寫進標籤,對應行為就會生效,例如:
以 required 為例,常見的錯誤寫法如下:
<!-- 請勿照抄!這是錯的 -->
<input type="email" name="email" required="true" />
<!-- 另一個錯誤例子 -->
<input type="email" name="email" required="1" />
更麻煩的是,如果你反過來寫 required="false":
<!-- 請勿照抄!這是錯的 -->
<input type="email" name="email" required="false" />
瀏覽器的 HTML 解析器只要看到 required 屬性存在,就會將它視為有效並執行驗證,即便你試圖用 false 關閉它——這顯然不是你想要的。布林屬性有三種合法寫法(後兩種僅在 XHTML 中有效):
required
required=""
required="required"
因此,前述範例的正確寫法應該是:
<input type="email" name="email" required />