許多開發者嘗試用 `<註解內容>` 來隱藏內容,卻發現瀏覽器並不理會。本文從瀏覽器解析機制解釋 HTML 註解的本質,釐清「標準註解」與「自訂標籤」的差異。
| 寫法 | 瀏覽器處理 | 結果 |
|---|---|---|
<!-- 註解 --> | 解析器識別為註解節點,不建立 DOM 元素,不渲染 | 完全隱藏,僅原始碼可見 |
<註解內容> | 解析器視為未知自訂元素,建立 HTMLUnknownElement 節點 | 不顯示內容,但存在於 DOM 樹中,可被 JS 選取 |
<!--` 進入「註解狀態」,直接消耗字元直到 `-->`,產出註解 Token。Comment 節點,掛載於 DOM 樹但不參與渲染樹構建。<my-tag>`),建立 HTMLUnknownElement,預設 `display: inline`,不具備任何語意與預設樣式。<!-- 標準註解 -->
<自訂標籤>這不會顯示,但存在於 DOM</自訂標籤>
<script>
// 開啟 DevTools Console 執行
console.log(document.querySelector('自訂標籤')); // 能選取到!
console.log(document.querySelector('自訂標籤').constructor.name); // HTMLUnknownElement
</script>
自訂標籤 { display: block; border: 1px solid red; }` 即可看見盒模型。| 需求 | 建議做法 |
|---|---|
| 原始碼不想被看到 | 建構階段移除註解(html-minifier) |
| 畫面暫時隱藏,保留 DOM | CSS: `display: none` 或 `visibility: hidden` |
| 畫面隱藏但保留佈局空間 | CSS: `visibility: hidden` |
| 條件式渲染(不輸出到 HTML) | 模板引擎條件判斷 / 框架 v-if / JS 動態建立 |
| 給開發者看的說明 | 標準 HTML 註解 `<!-- -->` |
理解瀏覽器解析機制,能避免濫用自訂標籤當註解,也能在需要自定義元素時(Web Components)正確使用 `customElements.define()` 註冊合法自訂元素。