| 類別 | 規則 | 範例 | 備註 |
|---|---|---|---|
| 成對標籤 (容器) | 必須有開始與結束標籤 | <div>...</div>, <p>...</p>, <span>...</span> | 大多數元素 |
| Void 元素 (空元素) | **不允許**有結束標籤,也不寫自閉合斜線 | <br>, <hr>, <img>, <input>, <meta>, <link>, <area>, <base>, <col>, <embed>, <param>, <source>, <track>, <wbr> | HTML5 規範明確列出 15 個 |
| 外來元素 (SVG/MathML) | **必須**自閉合 /> 或成對閉合 | <svg><circle /></svg>, <path d="..."/> | XML 命名空間要求 |
area, base, br, col, embed, hr, img, input, link, meta, param, source, track, wbr, colgroup* (僅當無內容)
正確:<img src="a.jpg" alt="..."> / <br> / <input type="text">
允許但非必要:<img src="a.jpg" /> (XML 風格,HTML 解析器忽略斜線)
錯誤:<img></img>, <br></br>, <input></input>
| 標籤 | 錯誤寫法 | 正確寫法 | 後果 |
|---|---|---|---|
<script> | <script src="a.js" /> | <script src="a.js"></script> | 瀏覽器將後續內容視為腳本內容,導致頁面空白/報錯 |
<iframe> | <iframe src="..." /> | <iframe src="..."></iframe> | 內容不顯示、父頁面樣式洩漏 |
<textarea> | <textarea /> | <textarea>預設值</textarea> | 無法顯示預設值 |
<select> | <select /> | <select><option>...</select> | 選單空白 |
<option> | <option value="1" /> | <option value="1">文字</option> | 選項無文字 |
/,視為屬性一部分 (無害)<br/> 合法,<br> 非法| 框架/工具 | 規則 | 注意事項 |
|---|---|---|
| JSX (React) | **所有元素必須閉合** <br />, <input /> | 編譯時轉為 React.createElement,遵循 XML 規則 |
| Vue SFC | 模板遵循 HTML 規則,void 元素可不寫 / | 編譯器會正確輸出 |
| Svelte | 同 Vue,HTML 規則 | |
| Angular | 模板遵循 HTML 規則 | |
| Nunjucks / EJS / Handlebars | 輸出純 HTML,遵循 HTML 規則 | 勿在模板寫 <script /> |
tag-self-close、tag-pairhtmlWhitespaceSensitivity)htmlhint **/*.html、prettier --check **/*.html有內容成對閉,Void 元素十五個。
Script、Iframe、Textarea,切記不要自閉合。
SVG、MathML 進 XML,斜線必加不馬虎。
JSX 框架要自閉,HTML 標準靠瀏覽器。
早年 XHTML 1.0/1.1 要求所有標籤關閉,養成 <br />, <img /> 習慣。HTML5 為了相容與簡化,明確定義 void 元素**不需也不應**有結束標籤。現代專案若非輸出 XHTML,**建議移除多餘斜線**,減少檔案體積與認知負擔。