HTML 註解是開發過程中不可或缺的文檔手段,正確的註解習慣能大幅提升代碼可維護性與團隊協作效率。本文系統整理註解語法、實戰範例,並附贈常用 HTML 標籤速查表。
<!-- 這裡是註解內容,瀏覽器不會渲染顯示 -->
<!--(驚嘆號後接兩個連字號)-->(兩個連字號後接大於號)-- 序列,否則會導致解析提前結束。<!-- 頁首導航區塊 START -->
<header>
<nav>...</nav>
</header>
<!-- 頁首導航區塊 END -->
<!--
待優化:以下輪播圖在行動裝置效能較差,
後續考慮改用 IntersectionObserver 延遲載入
-->
<div class="carousel">...</div>
| 標籤 | 說明 | 是否為雙標籤 |
|---|---|---|
<a> | 錨點/超連結 | 是 |
<div> | 區塊容器 | 是 |
<span> | 行內容器 | 是 |
<p> | 段落 | 是 |
<br> | 換行 | 否(自閉合) |
<img> | 圖片 | 否(自閉合) |
<ul>/<ol>/<li> | 列表 | 是 |
<table>/<tr>/<td> | 表格 | 是 |
<form>/<input>/<button> | 表單元素 | 視情況 |
<h1>-<h6> | 標題層級 | 是 |
<strong>/<em> | 語意強調/重點 | 是 |
養成良好的註解習慣,讓代碼自我解釋,減少溝通成本,是專業前端工程師的基本素養。