萬盛學電腦網

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

HTML 註釋語法與實務應用:單行、多行、條件註釋、建構工具標記完整指南

標準註釋語法

<!-- 單行註釋 -->
<!--
  多行註釋
  可跨越多行
-->

完整範例

<!DOCTYPE html>
<html lang="zh-Hant">
<head>
  <meta charset="UTF-8">
  <title>註釋示範</title>
</head>
<body>
  <!-- 頁首區塊開始 -->
  <header>
    <h1>網站標題</h1>
    <!-- 導航選單 -->
    <nav><ul><li><a href="/">首頁</a></li></ul></nav>
  </header>

  <main>
    <article>
      <h2>文章標題</h2>
      <p>文章內容...</p>
      <!-- TODO: 加入分享按鈕 -->
    </article>
  </main>

  <!-- 頁尾 -->
  <footer>© 2024 Company</footer>

  <!--[if IE]><script src="polyfill.js"></script><![endif]-->
</body>
</html>

進階應用模式

模式用途範例
區塊標記標示結構邊界<!-- Header Start --> ... <!-- Header End -->
代碼暫存暫時停用功能<!-- <div class="beta-feature">...</div> -->
待辦事項團隊協作標記<!-- FIXME: IE11 相容性 -->
建構工具指令Vite/Webpack/Gulp 區塊處理<!-- build:css assets/css/main.min.css -->
模板引擎標記Server-side include 邊界<!-- #include virtual="/partials/header.html" -->

⚠️ 重要限制

  • 不可巢狀:<!-- outer <!-- inner --> outer --> 會在 inner 結束處閉合。
  • 不可出現在標籤屬性內:<div <!-- comment --> class="x"> 非法。
  • 內容不可含 --:除啟始/結束標記外,註釋文本不能出現連續兩條連字號。
  • 生產環境建議移除:建構流程中用 html-minifier-terser 或 purgecss 移除,減少傳輸體積。
copyright © 萬盛學電腦網 all rights reserved