HTML5 帶來了一批語意化的新元素,但也讓不少開發者用錯了地方。以下整理六個最常見的誤用,並附上正確寫法。
最常見的錯誤之一,就是把 HTML5 的 <section> 直接當成 <div> 使用——純粹拿來當樣式容器。在 XHTML 或 HTML4 時代,我們常寫出這樣的結構:
<!-- HTML 4 style code -->
<div id="wrapper">
<div id="header">
<h1>My super duper page</h1>
<!-- Header content -->
</div>
<div id="main">
<!-- Page content -->
</div>
<div id="secondary">
<!-- Secondary content -->
</div>
<div id="footer">
<!-- Footer content -->
</div>
</div>
而到了 HTML5,很多人就直覺地改寫成:
<!-- 請不要照抄這段!這是錯的! -->
<section id="wrapper">
<header>
<h1>My super duper page</h1>
<!-- Header content -->
</header>
<section id="main">
<!-- Page content -->
</section>
<section id="secondary">
<!-- Secondary content -->
</section>
<footer>
<!-- Footer content -->
</footer>
</section>
這樣用並不對:section 不是樣式容器。section 元素代表的是內容中一個用來幫助建構文件大綱的語意區段,它應該有一個標題。如果你只是想找一個包住整頁的容器(沿用 HTML/XHTML 的舊習慣),不妨直接把樣式寫在 body 元素上;如果確實需要額外的樣式容器,那就老實繼續用 div。
依照這個思路,下面才是正確的 HTML5 寫法(搭配部分 ARIA role,實際上依設計需要也可能仍要加 div):
<body>
<header>
<h1>My super duper page</h1>
<!-- Header content -->
</header>
<div role="main">
<!-- Page content -->
</div>
<aside role="complementary">
<!-- Secondary content -->
</aside>
<footer>
<!-- Footer content -->
</footer>
</body>
寫不必要的標籤毫無意義,但 header 與 hgroup 卻經常被濫用。先記住兩個定義:
由於 header 在一份文件裡可以出現多次,很多人就寫成這樣:
<!-- 請不要照抄!這裡根本不需要 header -->
<article>
<header>
<h1>My best blog post</h1>
</header>
<!-- Article content -->
</article>
如果你的 header 裡只有一個標題元素,那就果斷把 header 拿掉。article 元素本身就保證了標題會被納入文件大綱,而 header 在這種情況下又沒有承載多個元素的作用,多寫一層只是徒增負擔:
<article> <h1>My best blog post</h1> <!-- Article content --> </article>
在只有一個子標題時,不需要同時使用 hgroup 與 header:
<!-- 請不要照抄!這裡不需要 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 -->
<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 一口氣引入了約 30 個新元素(以當時規格為準),我們在挑選語意化標籤時反而變得不夠謹慎,很容易走向「過度語意化」。nav 就是最典型的受害者。規格的說法是:
nav 元素代表頁面中區塊性的導覽區域,也就是連結到其他頁面或本頁其他部分的區塊。
注意:並非頁面上所有連結都該放進 nav——這個元素的本意是用於主要的導覽區塊。舉例來說,footer 中常有大量連結,例如服務條款、關於我們、版權聲明等;footer 元素本身就足以勝任,雖然 nav 也能用,但通常顯得多餘。
— WHATWG HTML spec
關鍵詞是「主要」。什麼算主要,大家大可討論一整天,我的判斷標準是:
以下這些,我的建議是不要放進 nav:
不確定時,問自己兩個問題:
如果答案都是「否」,那就跟 nav 道個別,放它走。
跟前面一樣,這裡的問題依然是寫了不必要的標籤。我見過不少網站把每一張圖都包成 figure,這除了讓自己更麻煩,並不會讓內容更清晰。
規格把 figure 描述為「一塊流動內容,可有可無地附帶自己的標題說明,通常在文件流中作為獨立單元被引用」。這正是 figure 的美妙之處——它可以從主內容移到側邊欄,而不影響文件流。
判斷方式可以這樣問:「這張圖必須跟上下文有關嗎?」如果只是為了裝飾而放,也沒有在別處被引用,那它絕對不是 figure。再問:「我可以把它移到附錄裡嗎?」如果兩題都成立,它大概才是 figure。
再進一步說,logo 也不該包在 figure 裡。以下是我常看到的寫法:
<!-- 請不要照抄!這是錯的 -->
<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 該不該放進 h1,是可以另外討論的話題,但這裡的重點是 figure 被濫用了。figure 只適合用來引用文件中的內容,或被 section 元素圍繞——你的 logo 顯然不會以這種方式被引用。簡單寫就好:
<header> <h1>My company name</h1> <!-- More stuff in here --> </header>
另一個常見誤解是「figure 只能放圖片」。實際上 figure 可以是影片、音訊、圖表、一段引文、表格、一段程式碼、一段文字,或它們的任意組合。別把 figure 侷限在圖片上——網路標準的職責就是精確地描述內容。
這嚴格說來不算錯誤,而是風格問題,但值得用最佳實踐來避免。在 HTML5 中,script 與 style 元素已經不需要 type 屬性。有些 CMS 會自動補上,移除起來不容易;但如果你是手工撰寫或完全掌控範本,就沒什麼理由繼續帶著它——所有瀏覽器都預設腳本是 JavaScript、樣式是 CSS。
<!-- 請不要照抄!太冗餘了! --> <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 為表單引入了一些新屬性,使用時有幾個要留意的地方。
部分多媒體元素與其他元素也有布林屬性,同樣適用以下規則。
有些新的表單屬性是布林型的,也就是說它們只要出現在標籤中,對應行為就已啟用。這類屬性包含:
以 required 為例,常見的錯誤寫法是:
<!-- 請不要照抄!這是錯的! --> <input type="email" name="email" required="true" /> <!-- 另一個錯誤的例子 --> <input type="email" name="email" required="1" />
嚴格說這不會出錯,瀏覽器的 HTML 解析器只要看到 required 出現,就會套用該功能。但如果你反過來寫成 required="false" 呢?
<!-- 請不要照抄!這是錯的! --> <input type="email" name="email" required="false" />
解析器依然會把 required 視為有效並執行驗證,這顯然不是你想要的結果。
布林屬性有三種正確寫法(後兩種僅在 XHTML 中有效):
requiredrequired=""required="required"所以上面那個例子應該寫成:
<input type="email" name="email" required />
本文的整理,要感謝 Ian Devlin、Derek Johnson、Tady Walsh、HTML5 Gallery 的策展團隊,以及 HTML5 Doctors 提供的寶貴意見。