萬盛學電腦網

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

HTML 註解語法與最佳實務:條件註解、工具整合與無障礙考量

基本語法

<!-- 單行註解 -->
<!--
  多行註解
  可跨越多行
-->
  • 以 <!-- 開始,--> 結束
  • 註解內容不會渲染,但會出現在原始碼/DevTools
  • 註解內不可包含 -- 序列(除開頭結尾),否則解析錯誤

條件註解(IE 專用,已棄用)

<!--[if IE]>
  <link rel="stylesheet" href="ie.css">
<![endif]-->
<!--[if gt IE 9]><!-->
  <link rel="stylesheet" href="modern.css">
<!--<![endif]-->

現代專案請使用 特性偵測、Polyfill、Progressive Enhancement 取代。

實用註解模式

區塊標記

<!-- Header Start -->
<header>...</header>
<!-- Header End -->

模板引擎區塊

<!-- @section('content') -->
...內容...
<!-- @endsection -->

建置標記

<!-- build:css css/main.min.css -->
<link rel="stylesheet" href="css/base.css">
<link rel="stylesheet" href="css/layout.css">
<!-- endbuild -->

TODO/FIXME 標記

<!-- TODO: 替換為 SVG Icon -->
<!-- FIXME: IE11 flex bug -->

生產環境移除註解

  • HTML 壓縮工具:html-minifier-terser, PostHTML
  • 保留特定註解:<!--! 重要授權宣告 --> (html-minifier ignoreCustomComments: [/^!/])

無障礙與 SEO 影響

  • 註解不影響 SEO(搜尋引擎忽略)
  • 螢幕閱讀器不讀取註解內容
  • 敏感資訊(API Key、內部路徑、TODO)嚴禁留在生產碼

延伸閱讀

copyright © 萬盛學電腦網 all rights reserved