萬盛學電腦網

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

HTML 註解符號完整對照表:HTML、CSS、JavaScript 三語言註解語法比較

三語言註解語法速查

語言單行註解多行註解範例
HTML無單行專用<!-- 註解 --><!-- Header -->
CSS無單行專用/* 註解 *//* color: red; */
JavaScript// 註解/* 註解 */// console.log()

HTML 註解細節

  • 標準:<!-- 內容 -->
  • 多行:起始 <!--,結尾 -->,中間可跨行
  • 不可巢狀:<!-- A <!-- B --> A --> 會在 B 結尾處結束
  • 不可包含 -- 序列 (除開頭結尾)
  • 條件註解 (IE):**已淘汰**,現代專案勿用

CSS 註解細節

  • 唯一語法:/* ... */,可單行可多行
  • 不可巢狀 (CSS 標準),但 PostCSS/SCSS 可透過插件支援
  • 常用於區塊標題:/* === Header === */
  • 建構工具可移除:cssnano discardComments

JavaScript 註解細節

  • // 到行尾
  • /* ... */ 可跨行,不可巢狀
  • JSDoc 文件註解:/** @param {string} name */
  • TypeScript 同 JS,另支援 /// <reference /> 三斜線指令

混合環境常見錯誤

<style>
  /* CSS 註解正確 */
  /* <!-- HTML 註解在 CSS 內無效 --> */
</style>

<script>
  // JS 註解正確
  /* HTML 註解在 JS 內無效 */
  // <!-- 錯誤 -->
</script>

<!-- HTML 註解包裹 CSS/JS (舊式隱藏腳本寫法,現代無需) -->
<script>
<!--
  // 舊瀏覽器不支援 script 時會顯示代碼,此寫法隱藏
// -->
</script>

工具整合

延伸閱讀

copyright © 萬盛學電腦網 all rights reserved