優秀的 CSS 不僅要跑通,更要可讀、可維護、高性能。從文件索引到 Sprites 技術,建立專業級 CSS 工程化規範。
每個 CSS 檔案頂部應包含標準化註釋索引:
/*
Project: 網站名稱
Author: 作者
Date: 2024-01-15
Version: 1.0
Description: 全站通用樣式
Structure:
1. Reset / Normalize
2. Layout
3. Components
4. Utilities
5. Pages
*/
包含:作者、版本、項目結構說明、色盤、字體定義等。
用特殊字符標記章節,編輯器搜尋即可跳轉:
/* ==== @Layout ==== */
/* ==== @Components ==== */
/* ==== @Utilities ==== */
搜尋 @Layout 直達佈局區塊。
.mainMenu ul li { } 而非通用 li { }.header、.mainNav、.sidebar、.footer.btn-primary、.form-input、.card-title.is-active、.is-hidden、.has-error.block__element--modifier/* 邊距 */
margin: 10px 8px 12px 5px; /* 上右下左 */
padding: 10px 8px; /* 上下 左右 */
/* 背景 */
background: #333 url(icon.png) no-repeat 50% 50%;
/* 字體 */
font: italic bold 12px/1.5 "Microsoft YaHei", sans-serif;
/* 邊框 */
border: 1px solid #ccc;
background-position 定位顯示sprite-loader、Gulp spritesmith 自動生成