HTML 歷經 20 多年演進 (HTML4 → XHTML → HTML5),但基本原則始終不變:**語意化、結構清晰、關注點分離、效能優先、無障礙友善**。本文整理 15 條現代 Web 開發鐵律,附違規/合規對照、工具鏈與自動化檢查方案。

<!-- ❌ 悪例:無語意 Div 堆砌 -->
<div class="header"></div>
<div class="content"><div class="sidebar"></div></div>
<div class="footer"></div>
<!-- ✅ 佳例:HTML5 語意標籤 -->
<header></header>
<main>
<article></article>
<aside></aside>
</main>
<footer></footer>
語意標籤優勢:SEO 友善、螢幕閱讀器無障礙、程式碼可讀性高、CSS 選擇器更簡潔。
<!-- ❌ 悪例 -->
<p style="color:#CCC;font-size:16px;font-family:arial">...</p>
<!-- ✅ 佳例 -->
<link rel="stylesheet" href="/css/main.min.css">
<p class="muted-text">...</p>
分離優勢:快取可複用、團隊協作不衝突、維護單一修改點、CSP 安全策略相容。
推薦框架:Tailwind CSS (原子化、按需編譯)、Bootstrap 5 (模組化)、Open Props (純 CSS 變數庫)。
<!-- ❌ 悪例:head 內阻塞 -->
<script src="/js/app.js"></script>
<!-- ✅ 佳例:body 結尾 defer/async -->
<script src="/js/app.js" defer></script>
<!-- 或 -->
<script src="/js/vendor.js" async></script>
<h1>頁面主標題 (每頁僅一個)</h1>
<h2>區塊標題</h2>
<h3>子區塊標題</h3>
<h2>另一區塊</h2>
原則:不可跳級 (h1 後直接 h3)、每頁一個 h1、輔助技術依賴大綱導航。
| 場景 | 正確標籤 | 錯誤用法 |
|---|---|---|
| 強調文字 | <em> / <strong> | <span style="font-weight:bold"> |
| 段落 | <p> | <br><br> 或 <div></div> |
| 清單群組 | <ul>/<ol>/<dl> | <div> 配合 <br> |
| 引用區塊 | <blockquote> | <div class="quote"> |
| 程式碼 | <code> / <pre><code> | <pre> 直接放文字 |
<!-- ❌ 不需 div -->
<div style="display:block">文字</div>
<!-- ✅ 直接用語意標籤或 CSS -->
<span class="block-text">文字</span>
.block-text { display: block; }
<nav>
<ul class="nav">
<li><a href="/>首頁</a></li>
<li><a href="/about">關於我們</a></li>
<li><a href="/contact">聯絡我們</a></li>
</ul>
</nav>
.nav { display: flex; gap: 1rem; list-style: none; }
<!-- ✅ 自閉合 -->
<img src="logo.png" alt="Logo" />
<input type="text" />
<br />
<hr />
<!-- ✅ 雙標籤完整閉合 -->
<div>內容</div>
<p>段落</p>
<li>項目</li> <!-- 可省略但建議保留 -->
HTML5 解析器雖容錯,但未閉合標籤導致 DOM 樹異常、CSS 選擇器失效、JS 選取錯誤。
<!-- ❌ 大寫可讀性差 -->
<DIV CLASS="CONTAINER"><IMG SRC="IMG.JPG" /></DIV>
<!-- ✅ 小寫規範 -->
<div class="container"><img src="img.jpg" alt="" /></div>
<!-- ❌ 空 alt 或無意義 -->
<img src="chart.png" alt="chart" />
<!-- ✅ 描述內容/功能 -->
<img src="chart.png" alt="2024 年 Q1 營收長條圖:月均增長 12%" />
<img src="icon-search.svg" alt="" role="presentation" /> <!-- 純裝飾圖片 alt="" -->
<form>
<fieldset>
<legend>個人資料</legend>
<label for="name">姓名</label>
<input type="text" id="name" name="name" required />
<label for="email">Email</label>
<input type="email" id="email" name="email" required />
</fieldset>
<button type="submit">送出</button>
</form>
優點:點擊 label 聚焦輸入框、螢幕閱讀器正確朗讀、鍵盤導航友善、CSS 選擇器更簡潔。
<!--[if IE 9]>
<link rel="stylesheet" href="css/ie9.css">
<![endif]-->
<!--[if lte IE 8]>
<script src="js/ie8-polyfills.js"></script>
<![endif]-->
現代建議:使用 **PostCSS (Autoprefixer)** 自動添加廠商前綴,配合 `@supports` / 特性偵測 取代 Hack,逐步淘汰 IE 專用碼。
<!-- ❌ 多餘 -->
<div class="header"><!-- 頁首開始 --></div>
<!-- ✅ 關鍵結構分隔 -->
<!-- 主要內容區 -->
<main>...</main>
<!-- 頁尾 -->
<footer>...</footer>
注意:驗證通過 ≠ 效能優異,需結合實測指標。
name: HTML Quality
on: [push, pull_request]
jobs:
validate:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Install html-validate
run: npm ci
- name: Validate HTML
run: npx html-validate "**/*.html"
- name: Lighthouse CI
run: npx lhci autorun
這 15 條鐵律不是束縛,而是通往**可維護、高效能、無障礙、SEO 友善**網站的捷徑。將其內化為團隊編碼規範,配合 Lint、Formatter、CI 自動化,讓機器守住底線,人類專注創造價值。HTML 是 Web 的骨架,寫好它,一切上層建築才穩固。