萬盛學電腦網

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

CSS 命名規範實戰:語意化、可維護、團隊協作的黃金法則

命名亂象的代價

.aaabb { margin: 2px; color: red; }
.red { color: blue; }        /* 改色後類名失真 */
.leftBar { ... }             /* 改成右側邊欄類名矛盾 */

以上反面教材導致:修改樣式時類名失真、重構風險高、團隊溝通成本大增。

核心原則:命名「是什麼」,而非「長怎樣」

  • ✅ #navigation、.sidebar、.post-wrap、.btn-primary
  • ❌ .red-text、.big-font、.float-left、.margin-10

推薦命名模式:BEM 變體

/* 區塊 */
.nav {}

/* 元素 */
.nav__item {}
.nav__link {}

/* 修飾符 */
.nav__item--active {}
.nav__link--external {}

優點:結構清晰、專一性可控、無嵌套地獄、易於搜尋與重構。

功能性類別:可複用的工具類

固定不變的工具模式,可用外觀描述命名:

.align-left  { float: left; margin-right: 1rem; }
.align-right { float: right; margin-left: 1rem; }
.clearfix::after { content: ""; display: table; clear: both; }
.visually-hidden { position: absolute; width: 1px; height: 1px; overflow: hidden; }

使用時在 HTML 切換類別:<p class="align-left">...</p> → 改為 align-right 即可,無需動 CSS。

命名規範清單

  1. 全小寫,單字以連字號 - 分隔(kebab-case)。
  2. ID 僅用於 JavaScript 掛鉤或頁面錨點,樣式優先用 Class。
  3. 模組前綴避免衝突:.header-、.footer-、.modal-。
  4. 狀態類別用 is-、has- 前綴:.is-active、.has-error。
  5. JS 專用掛鉤用 js- 前綴:.js-modal-trigger,CSS 勿對其設樣式。

工具輔助

  • Stylelint:selector-class-pattern 強制命名規則。
  • CSS Modules / Styled Components:編譯期自動生成唯一 hash 類名,根治衝突。
  • Figma / Zeplin 設計稿命名同步至程式碼。

良好的命名是給未來自己與團隊最好的禮物。從今天開始,拒絕 .div1、.left-red,擁抱語意化命名。更多架構級 CSS 規範,請關注本站工程化專題。

copyright © 萬盛學電腦網 all rights reserved