萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML5 教學

理解 HTML 註解機制:為何自訂標籤會被瀏覽器忽略?

許多開發者嘗試用 `<註解內容>` 來隱藏內容,卻發現瀏覽器並不理會。本文從瀏覽器解析機制解釋 HTML 註解的本質,釐清「標準註解」與「自訂標籤」的差異。

標準註解 vs 自訂標籤

寫法瀏覽器處理結果
<!-- 註解 -->解析器識別為註解節點,不建立 DOM 元素,不渲染完全隱藏,僅原始碼可見
<註解內容>解析器視為未知自訂元素,建立 HTMLUnknownElement 節點不顯示內容,但存在於 DOM 樹中,可被 JS 選取

瀏覽器解析流程簡述

  1. Tokenization(標記化): 遇到 `<!--` 進入「註解狀態」,直接消耗字元直到 `-->`,產出註解 Token。
  2. Tree Construction(樹構建): 註解 Token 產生 Comment 節點,掛載於 DOM 樹但不參與渲染樹構建。
  3. 未知標籤處理: 遇到不認識的標籤(如 `<my-tag>`),建立 HTMLUnknownElement,預設 `display: inline`,不具備任何語意與預設樣式。

驗證實驗

<!-- 標準註解 -->
<自訂標籤>這不會顯示,但存在於 DOM</自訂標籤>

<script>
  // 開啟 DevTools Console 執行
  console.log(document.querySelector('自訂標籤')); // 能選取到!
  console.log(document.querySelector('自訂標籤').constructor.name); // HTMLUnknownElement
</script>

為何自訂標籤「看起來」不顯示?

  • 預設 `display: inline`,無內容寬高為 0。
  • 無預設樣式(無 margin、padding、color 等)。
  • 若加上 CSS `自訂標籤 { display: block; border: 1px solid red; }` 即可看見盒模型。

正確隱藏內容的方法

需求建議做法
原始碼不想被看到建構階段移除註解(html-minifier)
畫面暫時隱藏,保留 DOMCSS: `display: none` 或 `visibility: hidden`
畫面隱藏但保留佈局空間CSS: `visibility: hidden`
條件式渲染(不輸出到 HTML)模板引擎條件判斷 / 框架 v-if / JS 動態建立
給開發者看的說明標準 HTML 註解 `<!-- -->`

理解瀏覽器解析機制,能避免濫用自訂標籤當註解,也能在需要自定義元素時(Web Components)正確使用 `customElements.define()` 註冊合法自訂元素。

copyright © 萬盛學電腦網 all rights reserved