聲明區塊語法基礎
選擇器 {
屬性1: 值1; /* 分號分隔每個聲明 */
屬性2: 值2;
屬性3: 值3 /* 最後一個聲明分號可省略,但建議保留 */
}
分號:分隔符而非結束符
- CSS 規範定義分號為聲明間的分隔符
- 最後一個聲明後可省略分號 (合法但不推薦)
- 最佳實踐:每行聲明結尾保留分號,防止新增屬性時遺漏導致解析錯誤
格式化風格對比
單行緊湊風格 (屬性 ≤ 3 時)
.btn { padding: 0.5rem 1rem; border-radius: 4px; background: #007bff; }
.icon { width: 1em; height: 1em; vertical-align: middle; }
多行展開風格 (標準推薦,屬性 > 3)
.card {
display: flex;
flex-direction: column;
padding: 1.5rem;
border-radius: 8px;
background: #fff;
box-shadow: 0 2px 8px rgba(0,0,0,0.1);
transition: transform 0.2s, box-shadow 0.2s;
}
屬性分組風格 (大型規則)
.complex-component {
/* Layout */
display: grid;
grid-template-columns: 1fr 3fr;
gap: 1.5rem;
/* Box Model */
padding: 2rem;
border: 1px solid var(--color-border);
border-radius: 12px;
/* Visual */
background: var(--color-surface);
box-shadow: var(--shadow-lg);
/* Typography */
font-size: 0.9375rem;
line-height: 1.6;
color: var(--color-text);
/* Interaction */
transition: box-shadow 0.3s ease;
}
選擇器分組格式化
/* 每個選擇器獨佔一行,最後一個前無逗號 */
h1,
h2,
h3,
.title {
font-weight: 600;
line-height: 1.3;
}
/* 避免 */
h1, h2, h3, .title { ... } /* 難閱讀、Diff 噪音大 */
自動化強制統一
/* .prettierrc */
{
"singleQuote": true,
"tabWidth": 2,
"printWidth": 100,
"cssSingleQuote": true
}
/* stylelint 配置 */
"rules": {
"declaration-block-single-line-max-declarations": 1,
"declaration-block-no-redundant-longhand-properties": true,
"block-closing-brace-newline-after": "always",
"selector-list-comma-newline-after": "always"
}
團隊協作公約範例
- 縮排:2 空格 (不可用 Tab)
- 冒號後一空格:
property: value;
- 左大括號前一空格:
selector {
- 右大括號獨佔一行,與選擇器對齊
- 顏色小寫十六進位:
#ff0000 → #f00 (可縮寫時)
- 數值 0 省略單位:
margin: 0; 不寫 0px
- 引號統一單引號