萬盛學電腦網

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

CSS 命名規範參考指南:語義化、結構化、可維護的類名體系

命名原則

  1. 語義化:描述「是什麼」,而非「長什麼樣」(如 .news-list 而非 .left-red-box)
  2. 結構化:反映 DOM 階層與模塊關係(BEM、SMACSS、ITCSS)
  3. 一致性:全項目統一命名風格(kebab-case、前綴體系)
  4. 可擴展:預留修飾符位置,避免覆寫戰爭

頁面結構類(佈局骨架)

語義推薦類名別名/縮寫
整體容器.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

功能模塊類(UI 組件)

模塊推薦類名修飾符示例
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

BEM 命名實戰範例

<!-- 區塊 --> 
<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 + stylelint-config-bem / stylelint-config-standard
  • CSS Comb / Prettier 統一格式化
  • IDE 插件:CSS class name completion、BEM snippets

總結

優秀的 CSS 命名是「代碼即文檔」。遵循 語義化 > 結構化 > 簡潔性 的優先級,採用 BEM 或類似體系,配合狀態前綴(is-/has-)與修飾符(--),能讓團隊在專案增長時依然保持樣式表的可讀性、可維護性與可擴展性。

copyright © 萬盛學電腦網 all rights reserved