類名是 HTML 與 CSS 的契約接口。糟糕的命名會導致:
.red-text 變綠).l13k { color: #369; }
.x7b2 { margin: 10px; }
完全不可維護,純粹給壓縮工具用的。
.left-blue { color: #369; }
.box-200 { width: 200px; }
.float-left { float: left; }
.red-button { background: red; }
陷阱:
.left-blue 語義謊言.blue 類名誤導.box-200 失真.product-description { color: #369; }
.sidebar-widget { width: 200px; }
.nav-item { float: left; }
.btn-primary { background: #0066cc; }
優勢:業務語義穩定,視覺變更零修改 HTML,團隊溝通零歧義。
需要命名新類?
├─ 是否描述「內容/功能」而非「外觀」?
│ ├─ 是 → ✅ 語義化命名(如 .user-avatar, .order-list, .btn-submit)
│ └─ 否 → 重新思考:能否提煉業務語義?
├─ 是否為通用工具類?
│ ├─ 是 → 統一前綴 .u- / .util-(如 .u-text-center, .u-mt-16)
│ └─ 否 → 組件內部類:採用 BEM .block__element--modifier
└─ 是否為狀態類?
├─ 是 → is-/has- 前綴(如 .is-active, .has-error, .is-loading)
└─ 否 → 繼續分析...
<article class="article-card">
<header class="article-card__header">
<h2 class="article-card__title">標題</h2>
<time class="article-card__meta">2024-01-15</time>
</header>
<div class="article-card__body">摘要...</div>
<footer class="article-card__footer">
<a class="article-card__link article-card__link--primary">閱讀全文</a>
<button class="article-card__btn article-card__btn--ghost">收藏</button>
</footer>
</article>
| 業務場景 | 推薦類名 | 避免類名 |
|---|---|---|
| 主要操作按鈕 | .btn-primary / .btn-submit | .btn-blue, .btn-big, .submit-btn |
| 錯誤提示區塊 | .alert-error / .form-error | .red-box, .error-msg |
| 用戶頭像 | .user-avatar / .avatar | .img-round, .pic-small |
| 商品價格 | .product-price / .price | .font-red, .text-bold |
| 導航當前項 | .nav-item.is-current | .active, .selected, .current |
| 載入中狀態 | .is-loading / .skeleton | .loading, .spinner |
.red-text → .text-error好的類名是業務語義的直接映射,而非視覺描述的縮寫。 當你猶豫該叫 .blue-button 還是 .btn-primary 時,請問自己:「如果設計師明天把按鈕改成綠色,這個類名還合理嗎?」答案顯而易見。投資於語義化命名,是在為專案的長期可維護性存款。