HTML5 定義超過 100 個標準元素。本手冊依功能分類整理核心標籤,附上語義、必要屬性、常見屬性、嵌套規則與最佳實踐,供開發快速查閱。完整規範請參考 WHATWG HTML Living Standard。
| 標籤 | 語義 | 關鍵屬性 | 備註 |
|---|---|---|---|
<!DOCTYPE html> | 宣告 HTML5 文件型別 | 無 | 必置於檔案最開頭,觸發標準模式 |
<html> | 文件根元素 | lang | 建議 lang="zh-Hant" |
<head> | 元資料容器 | — | 子元素:title、meta、link、style、script、base |
<title> | 文件標題 | — | 僅一個,SEO 關鍵 |
<meta> | 元資料 | charset、name、content、http-equiv | charset="UTF-8"、viewport、description、theme-color |
<link> | 外部資源連結 | rel、href、as、crossorigin | rel: stylesheet、preload、prefetch、icon、canonical |
<style> | 內嵌樣式 | media | 建議放 <head>,或用 link rel=preload as=style 非同步載入 |
<script> | 腳本 | src、async、defer、type=module、crossorigin | 模組腳本預設 defer;async 獨立執行不保證順序 |
<base> | 基準 URL | href、target | 全文件相對連結基準,謹慎使用 |
| 標籤 | 語義 | 關鍵屬性 | 備註 |
|---|---|---|---|
<body> | 文件可見內容 | — | 唯一 |
<header> | 頁首/區塊標題群 | — | 可包含 h1~h6、logo、導覽、搜尋 |
<nav> | 主要導覽連結群 | — | 不一定要放所有連結,僅主要導覽 |
<main> | 文件主要內容 | — | 全文件僅一個,不得為 ancestor of article/aside/footer/header/nav |
<article> | 獨立完整內容單元 | — | 部落格文、新聞、論壇貼文、產品卡片 |
<section> | 主題性區塊 | — | 通常帶標題,非通用容器(通用用 div) |
<aside> | 側邊/輔助內容 | — | 側邊欄、引言、廣告、相關連結 |
<footer> | 頁尾/區塊尾部 | — | 作者、版權、相關連結、聯絡資訊 |
<h1>~<h6> | 標題階層 | — | 嚴格遵循階層,h1 僅一個(主標題) |
<address> | 聯絡資訊 | — | 最近的 article/body 祖先的聯絡資訊 |
| 標籤 | 語義 | 關鍵屬性 | 備註 |
|---|---|---|---|
<p> | 段落 | — | 不可嵌套區塊元素 |
<a> | 超連結 | href、target、rel、download | rel: noopener、noreferrer、nofollow、external |
<em> | 強調語氣 | — | 巢狀疊加強調度 |
<strong> | 重要性 | — | 比 em 更強 |
<small> | 側註/小字 | — | 免責聲明、版權、法律文字 |
<s> | 不再準確/相關 | — | 非刪除(del),如舊價格 |
<cite> | 作品標題引用 | — | 書名、電影、論文、專案名 |
<q> | 短行內引語 | cite | 瀏覽器自動加引號,長引語用 blockquote |
<blockquote> | 區塊引語 | cite | 通常包含 p、footer、cite |
<dfn> | 定義術語 | — | 搭配 title 或 abbr 說明定義 |
<abbr> | 縮寫 | title | 滑鼠懸停顯示完整名稱 |
<ruby> | 注音標記 | — | 子元素 rt、rp,中日韓常用 |
<data> | 機器可讀資料 | value | 如 <data value="399">NT$399</data> |
<time> | 日期/時間 | datetime | 機器可解析格式 YYYY-MM-DDThh:mm:ss |
<code> | 程式碼片段 | — | 行內,區塊用 pre+code |
<var> | 變數 | — | 數學/程式變數 |
<samp> | 程式輸出 | — | 終端機輸出、錯誤訊息 |
<kbd> | 鍵盤輸入 | — | 巢狀 kbd 表示組合鍵 |
<sub>/<sup> | 下標/上標 | — | 化學式、數學公式、腳註 |
<i> | 慣用斜體語意 | — | 分類名、技術術語、思想語氣 |
<b> | 吸引注意 | — | 關鍵字、產品名,無重要性 |
<u> | 非文字標註 | — | 拼音錯誤、專有名詞標記 |
<mark> | 標記/高亮 | — | 搜尋關鍵字高亮、引用重點 |
<bdi> | 雙向隔離 | — | 隔離內文方向,防止破壞周圍文字 |
<bdo> | 覆蓋文字方向 | dir | dir="rtl"/"ltr" 強制方向 |
<span> | 通用行內容器 | — | 無語意,純樣式/JS 掛鉤 |
<br> | 換行 | — | 段落內強制換行 |
<wbr> | 斷行機會 | — | 長單字/URL 允許斷行點 |
| 標籤 | 語義 | 子元素 | 備註 |
|---|---|---|---|
<ul> | 無序列表 | <li> | 項目無順序 |
<ol> | 有序列表 | <li> | start、reversed、type |
<li> | 列表項目 | 流式內容 | 可巢狀 ul/ol |
<dl> | 描述列表 | <dt>、<dd> | 術語-定義、FAQ、中繼資料 |
<dt> | 術語/名稱 | — | — |
<dd> | 描述/值 | 流式內容 | 一個 dt 可對多 dd,反之亦可 |
| 標籤 | 語義 | 關鍵屬性 | 備註 |
|---|---|---|---|
<table> | 表格 | — | 不可用於版面配置 |
<caption> | 表格標題 | — | 緊接 table 之後,第一個子元素 |
<thead> | 表頭群組 | — | 包含 tr+th |
<tbody> | 表身群組 | — | 可多個,分頁列印自動重複 thead/tfoot |
<tfoot> | 表尾群組 | — | 摘要、合計行 |
<tr> | 列 | — | 子元素 th/td |
<th> | 標題儲存格 | scope、colspan、rowspan | scope: col/row/colgroup/rowgroup |
<td> | 資料儲存格 | colspan、rowspan | — |
<colgroup> | 欄群組 | span | 設定欄寬、樣式 |
<col> | 單欄 | span | colgroup 內使用 |
| 標籤 | 語義 | 關鍵屬性 | 備註 |
|---|---|---|---|
<form> | 表單 | action、method、enctype、novalidate | enctype: multipart/form-data (上傳檔案) |
<label> | 標籤 | for | for=id 關聯控件,或直接包裹控件 |
<input> | 輸入控件 | type、name、value、required、placeholder、autocomplete | type: text, email, password, number, date, checkbox, radio, file, hidden, submit, button, color, range, search, tel, url... |
<textarea> | 多行文字 | rows、cols、maxlength、wrap | — |
<select> | 下拉選單 | multiple、size | 子元素 option/optgroup |
<option> | 選項 | value、selected、disabled | — |
<optgroup> | 選項群組 | label、disabled | — |
<button> | 按鈕 | type、disabled、form、formaction | type: submit(預設)、reset、button;可包含 HTML 內容 |
<fieldset> | 表單群組 | disabled | 子元素 legend 必填 |
<legend> | 群組標題 | — | — |
<datalist> | 預選建議 | — | input list 屬性關聯 |
<output> | 計算結果 | for | 關聯輸入控件 |
<progress> | 進度條 | value、max | 確定性進度 |
<meter> | 度量儀 | value、min、max、low、high、optimum | 標量範圍 |
| 標籤 | 語義 | 關鍵屬性 | 備註 |
|---|---|---|---|
<img> | 影像 | src、alt、width、height、loading、decoding、srcset、sizes | alt 必填(裝飾性可空 alt=""),響應式圖片用 picture+source |
<picture> | 響應式圖片容器 | — | 子元素 source+img,瀏覽器依媒體查詢選擇 |
<source> | 媒體來源 | srcset、media、type | 用於 picture、video、audio |
<video> | 影片 | src、controls、poster、preload、loop、muted、playsinline | 子元素 source、track |
<audio> | 音訊 | src、controls、preload、loop、muted | 子元素 source、track |
<track> | 文字軌 | kind、src、srclang、label、default | kind: subtitles、captions、descriptions、chapters、metadata |
<iframe> | 內嵌瀏覽內容 | src、title、loading、sandbox、allow、referrerpolicy | title 必填(無障礙),sandbox 提升安全 |
<embed> | 外部應用/外掛 | src、type、width、height | 舊技術,優先用 video/audio/object |
<object> | 外部資源 | data、type、width、height | PDF、SVG、Flash(已棄用) |
<param> | 物件參數 | name、value | object 子元素 |
<canvas> | 位圖畫布 | width、height | JS 繪圖、WebGL、遊戲、圖表 |
<svg> | 向量圖形 | — | 可直接內嵌 SVG 標記 |
<map> | 圖像映射 | name | 配合 img usemap、area |
<area> | 映射區域 | shape、coords、href、alt | shape: rect、circle、poly、default |
| 標籤 | 語義 | 關鍵屬性 | 備註 |
|---|---|---|---|
<details> | 可展開細節 | open | 子元素 summary 必填,原生手風琴 |
<summary> | 細節摘要 | — | 點擊切換 open 狀態 |
<dialog> | 對話框 | open | JS showModal()/show()/close() 控制,::backdrop 樣式化背景 |
<slot> | Web Component 插槽 | name | Shadow DOM 內容分發 |
<template> | HTML 模板 | — | 內容不渲染,JS cloneNode(true) 使用 |
<script> | 腳本 | 見文件結構 | — |
<noscript> | 無腳本回退 | — | 瀏覽器禁用 JS 時顯示 |
<font>、<center>、<strike>、<big>、<tt>、<frame>、<frameset>、<noframes>、<applet>、<acronym>、<dir>、<isindex>、<listing>、<plaintext>、<xmp>、<basefont>、<bgsound>、<marquee>、<blink>、<nobr>。class、id、style、title、lang、dir、hidden、tabindex、accesskey、contenteditable、spellcheck、translate、data-*、aria-*、role、draggable、dropzone、inert、popover、enterkeyhint、inputmode、virtualkeyboardpolicy。熟悉標籤語義與正確嵌套,是撰寫可維護、無障礙、SEO 友善 HTML 的基石。建議將本手冊加入書籤,開發時隨時查閱;並搭配 WHATWG 標準、MDN Web Docs 深入學習各元素完整屬性與 DOM 介面。