三語言註解語法速查
| 語言 | 單行註解 | 多行註解 | 範例 |
| 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>
工具整合
延伸閱讀