.news-list 而非 .left-red-box)| 語義 | 推薦類名 | 別名/縮寫 |
|---|---|---|
| 整體容器 | .container / .wrapper | .wrap |
| 頁頭 | .header / .hd | .head |
| 主內容區 | .main / .content / .bd | .cnt |
| 側欄 | .sidebar / .side / .sd | .aside |
| 頁腳 | .footer / .ft | .foot |
| 導航總稱 | .nav / .navigation | |
| 主導航 | .nav-primary / .main-nav | .nav-main |
| 子導航 | .nav-secondary / .sub-nav | |
| 麵包屑 | .breadcrumb / .crumb |
| 模塊 | 推薦類名 | 修飾符示例 |
|---|---|---|
| Logo | .logo / .site-logo | |
| 搜索 | .search / .search-box | .search-btn, .search-input |
| 登錄/註冊 | .login / .register / .auth-form | |
| 按鈕組 | .btn-group / .button-group | .btn-primary, .btn-lg, .btn-disabled |
| 標籤頁 | .tabs / .tab-nav | .tab-item, .tab-panel, .is-active |
| 下拉菜單 | .dropdown / .drop-menu | .drop-trigger, .drop-panel |
| 列表 | .list / .item-list | .list-item, .list-link |
| 表格 | .table / .data-table | .table-row, .table-cell |
| 表單 | .form / .form-group | .form-label, .form-control, .form-error |
| 模態框 | .modal / .dialog | .modal-mask, .modal-body, .modal-close |
| 提示訊息 | .msg / .alert / .toast | .msg-success, .msg-error, .msg-warning |
| 分頁 | .pagination / .pager | .page-item, .page-link, .is-current |
| 前綴 | 語義 | 示例 |
|---|---|---|
| is- | 狀態(JS 切換) | .is-active, .is-hidden, .is-loading, .is-disabled |
| has- | 擁有特徵 | .has-image, .has-error, .has-submenu |
| with- | 帶有子模塊 | .with-sidebar, .with-avatar |
| no- | 無特定特徵 | .no-padding, .no-border, .no-result |
| -primary / -secondary | 視覺層級 | .btn-primary, .link-secondary |
| -lg / -sm / -xs | 尺寸規範 | .btn-lg, .text-sm, .avatar-xs |
<!-- 區塊 -->
<div class="card">
<!-- 元素 -->
<img class="card__image" src="" alt="">
<div class="card__body">
<h3 class="card__title">標題</h3>
<p class="card__desc">描述</p>
</div>
<footer class="card__footer">
<!-- 修飾符 -->
<button class="card__btn card__btn--primary">主要操作</button>
<button class="card__btn card__btn--ghost">次要操作</button>
</footer>
</div>
.red-text、.left-box、.big-font —— 表現類名,換膚/重構噩夢.header .nav li a span —— 過度嵌套,耦合 HTML 結構.m-t-10、.p-b-20 —— 原子類濫用,HTML 混雜樣式邏輯(Utility-first 框架除外).alert-error、.card__title--large、.nav-item.is-current —— 語義清晰、可組合stylelint-config-bem / stylelint-config-standard優秀的 CSS 命名是「代碼即文檔」。遵循 語義化 > 結構化 > 簡潔性 的優先級,採用 BEM 或類似體系,配合狀態前綴(is-/has-)與修飾符(--),能讓團隊在專案增長時依然保持樣式表的可讀性、可維護性與可擴展性。