萬盛學電腦網

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

CSS 編碼規範指南:避免過度約束、拒絕後代選擇器、合併聲明、格式化標準

核心原則:簡潔、可維護、高性能、語義化

規範一:避免過度約束選擇器

/* ❌ 糟糕:多餘限定 */
ul#nav { }
.menu#sidebar { }
button.btn-primary { }

/* ✅ 好的:ID/Class 自足 */
#nav { }
#sidebar { }
.btn-primary { }

ID 唯一、Class 可復用,標籤限定只會增加匹配開銷、降低復用性、提高私有度。

規範二:後代選擇器是性能與維護的殺手

/* ❌ 爛透了:深層耦合、性能差 */
html body header nav ul li a { }

/* ✅ 好的:扁平化 class */
.nav-link { }

後代選擇器導致 HTML 結構與 CSS 強耦合,結構微調即破壞樣式,大團隊中 HTML/CSS 分工時災難性後果。

規範三:盡可能使用合成/縮寫屬性

/* ❌ 糟糕:冗長、易遺漏、難維護 */
.box {
    padding-top: 20px;
    padding-bottom: 20px;
    padding-left: 10px;
    padding-right: 10px;
    background-color: #000;
    background-image: url(img.png);
    background-position: bottom;
    background-repeat: repeat-x;
}

/* ✅ 好的:合成屬性、語義分組 */
.box {
    padding: 20px 10px;
    background: #000 url(img.png) repeat-x bottom;
}

規範四:避免不必要的重複聲明

/* ❌ 糟糕:複製貼上修改顏色 */
.alert-error { color: red; background: #fee; padding: 10px; border-radius: 4px; }
.alert-success { color: green; background: #efe; padding: 10px; border-radius: 4px; }

/* ✅ 好的:提取基礎類 + 修飾類 */
.alert { padding: 10px; border-radius: 4px; }
.alert-error { color: red; background: #fee; }
.alert-success { color: green; background: #efe; }

規範五:組織良好的代碼格式

多選擇器分行

/* ✅ 好的:易讀、易 diff、易合併 */
.btn-primary,
.btn-secondary,
.btn-danger {
    padding: 8px 16px;
    border-radius: 4px;
}

屬性聲明順序(推薦:佈局→盒模型→視覺→動畫→其他)

.card {
    /* 佈局 */
    display: flex;
    flex-direction: column;
    
    /* 盒模型 */
    width: 100%;
    max-width: 400px;
    padding: 24px;
    margin: 0 auto 16px;
    
    /* 視覺 */
    background: #fff;
    border: 1px solid #e0e0e0;
    border-radius: 8px;
    box-shadow: 0 2px 8px rgba(0,0,0,0.08);
    
    /* 動畫 */
    transition: box-shadow 0.2s, transform 0.2s;
    
    /* 其他 */
    z-index: 1;
}

複雜值多行展開

.fancy {
    background-image:
        linear-gradient(45deg, #fff, #f0f0f0),
        url(pattern.png);
    box-shadow:
        0 4px 12px rgba(0,0,0,0.1),
        0 1px 3px rgba(0,0,0,0.08) inset;
}

規範六:命名規範(BEM 為基準)

/* 組件塊 */
.card { }

/* 元素 */
.card__header { }
.card__title { }
.card__body { }

/* 修飾符 */
.card--featured { }
.card__title--large { }

/* 狀態(is-/has- 前綴) */
.card.is-active { }
.card.has-error { }

規範七:註釋文檔化(參考上篇)

  • 區塊標題分隔
  • 準修飾選擇器
  • 代碼標簽索引
  • 繼承標記關聯

工具化落地

  • Stylelint:強制執行上述規範(selector-max-id, selector-max-compound-selectors, declaration-block-properties-order 等)
  • Prettier:統一格式化(縮進、引號、分號、換行)
  • CSSComb:屬性排序
  • Commit Hook:husky + lint-staged 提交前自動檢查

相關延伸閱讀

CSS @規則完整指南:charset、import、namespace、media、supports、keyframes、font-face、page、document

copyright © 萬盛學電腦網 all rights reserved