/* ==========================================================================
#HEADER - 頁頭區塊
========================================================================== */
/* 子區塊:Logo */
.logo { ... }
/* 子區塊:主導航 */
.nav-primary { ... }
/* =HEADER ================================================================ */
/* =NAV =================================================================== */
/* =CONTENT =============================================================== */
/* =FOOTER ================================================================ */
/* =UTILITIES ============================================================= */
/* =MEDIA QUERIES ========================================================= */
編輯器搜尋 =HEADER 即可跳轉,極大提升大文件導航效率。
/*
* @section Button Components
* @updated 2024-01-15
* @author Chen Wei
* @ticket #FE-1234: 新增 loading 狀態樣式
*/
/*
* 此處使用 zoom:1 觸發 hasLayout 修復 IE6/7 雙倍邊距 Bug
* 現代瀏覽器無影響,保留以兼容舊環境
*/
.clearfix { *zoom: 1; }
/*
* 故意使用 !important 覆蓋第三方 UI 庫內聯樣式
* 遷移至自建組件後可移除
*/
.override-third-party { color: #fff !important; }
/* TODO: 斷點 768px 與設計稿不符,待設計確認 */
/* FIXME: Safari 下 flex-grow 計算異常,需升級 polyfill */
/* HACK: 強制硬體加速修復 iOS 滾動閃爍,後續尋找根因 */
| 規範項 | 建議 |
|---|---|
| 編碼 | UTF-8 無 BOM,統一換行符 LF |
| 縮進 | 2 空格(或 4 空格,團隊統一) |
| 區塊分隔 | 頂級區塊用 /* ===== SECTION ===== */,子區塊用 /* --- Subsection --- */ |
| 錨點前綴 | 統一 = 或 @,配合編輯器書籤功能 |
| 刪除代碼 | 嚴禁註釋掉大段代碼,用版本控制(Git)追蹤歷史 |
| 文件頭部 | 必含:專案名、版本、作者、建立日期、最後修改、編碼聲明 |
comment-no-empty、comment-pattern 強制註釋規範postcss-strip-comments 構建時移除開發註釋,保留授權頭部TODO Highlight 擴展高亮標記、CSS Peek 快速跳轉kss-node、stylemark 從註釋生成樣式指南優秀的 CSS 註釋不是「解釋代碼在做什麼」(代碼自述),而是「解釋代碼為什麼這樣寫、有什麼副作用、如何擴展」。建立統一的註釋體系,配合工具鏈自動化檢查與文檔生成,能將樣式表從「唯有作者能讀懂的迷宮」轉化為「團隊共享的知識資產」。