萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> Div CSS 教學

CSS 編寫規範核心原則:選擇器最佳化、縮寫屬性、程式碼組織與團隊標準

CSS 編寫規範核心原則:選擇器最佳化、縮寫屬性、程式碼組織與團隊標準

統一的 CSS 編寫規範是團隊協作效率、程式碼可維護性、專案長期健康的基石。本文整理業界公認的核心原則:避免過度限定選擇器、善用縮寫屬性、消除重複、標準化格式化,並提供具體反面教材與正確範例對照。

原則一:避免過度限定選擇器

/* ❌ 糟糕:過度限定 */
ul#nav { }           /* ID 已唯一,ul 多餘 */
.menu#sidebar { }    /* ID 已唯一,.menu 多餘 */
div.container { }    /* class 已足夠,div 多餘 */
button.btn-primary { } /* 標籤限定降低複用性 */

/* ✅ 優秀:精準適度 */
#nav { }
#sidebar { }
.container { }
.btn-primary { }

危害:提高特定度(難覆蓋)、綁定 HTML 結構(換標籤樣式失效)、降低 class 複用性(.btn-primary 只能用在 button 上)。

原則二:拒絕深層後代選擇器

/* ❌ 爛透了:極深後代選擇器 */
html body div header nav ul li a { color: #333; }

/* 問題:效能低、極度脆弱、HTML/CSS 強耦合、結構微調即失效 */

/* ✅ 優秀:單一語意化 class */
.nav-link { color: #333; }

原則三:善用複合屬性縮寫

/* ❌ 糟糕:冗長分散 */
.some-class {
    padding-top: 20px;
    padding-right: 10px;
    padding-bottom: 20px;
    padding-left: 10px;
    background-color: #000;
    background-image: url('../imgs/carrot.png');
    background-position: bottom center;
    background-repeat: repeat-x;
}

/* ✅ 優秀:縮寫合併,順時針順序 */
.some-class {
    padding: 20px 10px;                    /* 上下 20px、左右 10px */
    background: #000 url('../imgs/carrot.png') repeat-x bottom center;
}

/* 進階:多重背景、多重陰影分行對齊 */
.advanced {
    background-image:
        linear-gradient(45deg, #000, #ccc),
        linear-gradient(#ccc, #ddd);
    box-shadow:
        2px 2px 4px #000,
        1px 4px 6px #ddd inset;
}

原則四:消除不必要重複(DRY 原則)

/* ❌ 糟糕:重複宣告 */
.btn-primary { color: #fff; background: #0066cc; font-size: 1rem; }
.btn-secondary { color: #fff; background: #6c757d; font-size: 1rem; }

/* ✅ 優秀:提取共同基礎 */
.btn { 
    color: #fff; 
    font-size: 1rem; 
    padding: 0.5rem 1rem; 
    border-radius: 0.375rem; 
}
.btn-primary { background: #0066cc; }
.btn-secondary { background: #6c757d; }

/* 或使用群組選擇器(僅限極簡單共同屬性) */
.btn-primary, .btn-secondary { color: #fff; font-size: 1rem; }

原則五:標準化程式碼格式化

可讀性 = 可維護性。建議採用統一格式化規則(配合 Stylelint/Prettier 強制):

/* ✅ 選擇器分行:易讀、易版控差異比較 */
.selector-one,
.selector-two,
.selector-three {
    property: value;
}

/* ✅ 多值屬性分行對齊 */
.complex {
    background-image:
        linear-gradient(#000, #ccc),
        linear-gradient(#ccc, #ddd);
    box-shadow:
        2px 2px 4px rgba(0,0,0,0.1),
        inset 1px 1px 0 rgba(255,255,255,0.5);
}

/* ✅ 屬性聲明順序建議(濃縮版) */
.ordered {
    /* 1. 佈局/定位 */
    position: relative;
    display: flex;
    z-index: 10;
    
    /* 2. 盒模型 */
    width: 100%;
    padding: 1rem;
    margin: 0 auto;
    
    /* 3. 視覺樣式 */
    background: #fff;
    border: 1px solid #ddd;
    border-radius: 0.5rem;
    
    /* 4. 字體/文字 */
    font: 1rem/1.5 sans-serif;
    color: #333;
    text-align: center;
    
    /* 5. 修飾/動畫/其他 */
    opacity: 1;
    transition: all 0.2s;
}

原則六:零值省略單位

/* ✅ 零值不需單位 */
margin: 0;
padding: 10px 0 20px 0;
border: 0;
outline: 0;
box-shadow: 0 0 0 0;

/* ❌ 多餘單位 */
margin: 0px;
padding: 10px 0px 20px 0px;  /* 雖合法但冗餘 */

原則七:顏色值規範化

/* 十六進位小寫、可縮寫則縮寫 */
color: #fff;       /* 不要 #FFFFFF */
color: #369;       /* 不要 #336699 */
background: #f0f0f0;

/* rgba/hsl 用於需要透明度時 */
color: rgba(0, 0, 0, 0.6);
background: hsla(200, 50%, 50%, 0.8);

/* CSS 變數引用 */
color: var(--color-text-primary);

原則八:媒體查詢內嵌寫法

/* ✅ 推薦:嵌套在元件內部(支援 PostCSS nesting 或原生 CSS Nesting) */
.card {
    padding: 1.5rem;
    
    @media (max-width: 768px) {
        padding: 1rem;
    }
    
    @media (min-width: 1200px) {
        padding: 2rem;
    }
}

/* ❌ 避免:集中在檔案底部的大量媒體查詢,難以維護關聯 */
@media (max-width: 768px) {
    .card { padding: 1rem; }
    .btn { font-size: 0.875rem; }
    /* ...數百行後難以對應元件 */
}

團隊規範落地清單

# .stylelintrc.json 核心規則範例
{
  "rules": {
    "selector-max-id": 0,                    // 禁止 ID 選擇器做樣式
    "selector-max-compound-selectors": 3,    // 限制複合選擇器深度
    "selector-class-pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*(__[a-z0-9]+(-[a-z0-9]+)*)?(--[a-z0-9]+(-[a-z0-9]+)*)?$", // BEM 命名強制
    "property-no-unknown": true,             // 禁止未知屬性
    "color-hex-case": "lower",               // 十六進位小寫
    "color-hex-length": "short",             // 強制縮寫
    "value-zero-unit": "never",              // 零值禁單位
    "declaration-block-semicolon-newline-after": "always", // 分號換行
    "rule-empty-line-before": "always-multi-line", // 規則間空行
    "at-rule-empty-line-before": "always",
    "custom-property-pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$" // CSS 變數命名
  }
}

總結

CSS 編寫規範的核心精神是「為了讀者而寫,不只是為了瀏覽器」。遵循淺層選擇器、縮寫合併、消除重複、統一格式、語意化命名、零值無單位、媒體查詢內嵌八大原則,配合自動化 Lint 工具強制執行,能讓團隊產出一致、可預測、易於重構的高品質樣式代碼。規範不是束縛,而是釋放創造力的基礎設施。

copyright © 萬盛學電腦網 all rights reserved