「多行展開」與「單行壓縮」各有適用場景,**關鍵在於團隊統一標準並自動化執行**。
| 場景 | 推薦風格 | 示例 |
|---|---|---|
| 常規組件/佈局規則集(≥4 聲明) | 多行展開 + 語義分組 | .card { display: flex; gap: 16px; padding: 24px; } |
| 單一聲明規則集 | 單行 | .u-hidden { display: none !important; } |
| 工具類/原子類(1-3 聲明,高復用) | 單行 | .mt-4 { margin-top: 1rem; }.d-flex { display: flex; } |
| 關鍵幀規則集 | 單行或緊湊多行 | @keyframes fadeIn { from { opacity: 0; } to { opacity: 1; } } |
| 媒體查詢/支持查詢包裹塊 | 多行展開,內部規則集遵循上述規則 | @media (width >= 768px) { .grid { grid-template-columns: 1fr 1fr; } } |
| CSS 變量定義區塊 | 多行展開,按語義分組 | :root { --color-primary: #0066cc; --spacing-md: 16px; } |
/* Stylelint 關鍵規則 */
"rules": {
"block-opening-brace-space-before": "always",
"declaration-block-single-line-max-declarations": 1, /* 強制多聲明拆行 */
"declaration-block-single-line-max-declarations": 3, /* 或允許 ≤3 單行,團隊二選一 */
"rule-empty-line-before": "always-multi-line", /* 多行規則集前空行 */
"custom-property-pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$" /* 變量命名規範 */
}
.red、.big)?CSS 可讀性標準的核心是**場景化規範 + 自動化強制 + 邏輯級 Code Review**。多行展開用於結構性規則,單行壓縮用於原子工具類,**絕不混用於同類場景**。配置一次 Prettier/Stylelint,終身免受格式糾結之苦。