/* 單行註釋 */
/*
多行註釋
可跨行
*/
⚠️ CSS 無單行 // 註釋(Less/Sass/Stylus 支援,但原生 CSS 不支援)。
/**
* 元件名稱:主要導覽列
* 描述:固定頂部、響應式摺疊、支援多層下拉
* 作者:Team UI
* 版本:2.1.0
* 依賴:variables.css, mixins.css
*
* 修改記錄:
* 2024-01-15 新增行動版漢堡選單動畫
* 2024-03-22 修正 IE11 flex bug
*/
避免過度修飾選擇器(如 ul.nav → .nav),但保留語意提示:
/* nav */ .primary-nav { } /* 預期掛在 <nav> */
/* ol */ .breadcrumb { } /* 預期掛在 <ol> */
/* p */ .lead-text { } /* 預期掛在 <p> */
/* ul */ .image-gallery { } /* 預期掛在 <ul> */
優點:不增加優先級、不影響複用性、文檔化預期 HTML 結構。
/* ==== RESET & BASE ==== */
/* >>> TYPOGRAPHY <<< */
/* --- COMPONENTS: BUTTON --- */
/* ### LAYOUT: GRID ### */
/* @@ THEME: DARK MODE @@ */
編輯器搜尋 >>>、---、###、@@ 可快速跳轉區段。
/* base.css */
/**
* @extend .card in components/card.css
*/
.card-base {
border-radius: 8px;
box-shadow: 0 2px 8px rgba(0,0,0,.1);
}
/* components/card.css */
/**
* @extends .card-base from base.css
*/
.card {
padding: 1.5rem;
background: #fff;
}
建立跨檔案的語意連結,便於重構與追蹤依賴。
/* 16px base * 1.5 = 24px */)selector-class-pattern、comment-pattern)postcss-discard-comments)建立註釋規範後,建議學習 CSS RGB 色彩模型與應用技巧,精準掌控視覺設計語言。