萬盛學電腦網

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

CSS 與 XHTML 命名規範完整指南:語意化、結構化、可維護

核心原則

  1. 語意化命名:名稱描述「是什麼」(.nav-primary),而非「長什麼樣」(.blue-bar)或「在哪裡」(.left-column)。
  2. 小寫 + 連字符:.main-content,不使用駝峰、底線、大寫。
  3. 模組化前綴:大型專案加項目/模組前綴(.m-header、.c-card),避免污染。
  4. ID 唯一、Class 可復用:ID 用於頁面級唯一區塊(#header、#footer),Class 用於可復用元件。
  5. 避免過度具體:.btn-primary 優於 .header-nav-btn-primary。

頁面結構層級命名

區塊推薦 ID/Class備註
整體容器#wrapper、.container控制整體最大寬度、置中
頁首#header、.header
主內容區#main、.main-content
側邊欄#sidebar、.sidebar左/右可加修飾:.sidebar-left
頁尾#footer、.footer
導航總稱#nav、.nav
主導航.nav-primary、.main-nav
子導航.nav-sub、.sub-nav
頂部導航.nav-top、.top-nav
欄目/專區.section、.column

功能模組命名

模組推薦 Class子元素建議
Logo.logo.logo-img, .logo-text
廣告/橫幅.banner, .ad.banner-img, .ad-link
搜尋.search, .search-form.search-input, .search-btn
登入/註冊.login, .register, .auth-form.form-field, .btn-submit
麵包屑.breadcrumb.breadcrumb-item, .breadcrumb-link
分頁.pagination.page-item, .page-link, .page-current
標籤頁.tabs, .tab-nav.tab-item, .tab-panel, .is-active
文章/卡片.post, .card, .article.post-title, .post-meta, .post-content
列表.list, .item-list.list-item
提示訊息.alert, .msg, .toast.alert-success, .alert-error
小技巧/Tips.tips, .tip
圖標.icon, .icon-font.icon-home, .icon-user
按鈕.btn.btn-primary, .btn-secondary, .btn-lg
表單.form, .form-group.form-label, .form-control, .form-error
模態框.modal, .dialog.modal-header, .modal-body, .modal-footer
下拉選單.dropdown.dropdown-toggle, .dropdown-menu, .dropdown-item

狀態與修飾類命名(BEM 風格)

/* 區塊 */
.card {}

/* 元素 */
.card__title {}
.card__image {}
.card__footer {}

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

/* 狀態類(跨組件通用) */
.is-active {}
.is-hidden {}
.is-disabled {}
.is-loading {}
.has-error {}
.is-expanded {}

常見錯誤避坑

  • ❌ .red-text、.left-box、.big-font(表象命名)
  • ❌ .div1、.span2、.box3(無語意流水號)
  • ❌ .header_nav_link(底線分隔、過度嵌套)
  • ✅ .nav__link、.nav-link、.nav__link--active

HTML5 語意標籤對應關係

優先使用語意標籤,Class 作為樣式掛鉤補充:

<header id="header" class="header">...</header>
<nav class="nav-primary">...</nav>
<main id="main" class="main-content">
  <article class="post">...</article>
  <aside class="sidebar">...</aside>
</main>
<footer id="footer" class="footer">...</footer>

團隊規範落地清單

  1. 制定 NAMING_CONVENTION.md 文件,列出所有認可的命名模式與禁用模式。
  2. 配置 stylelint-config-standard + 自定義規則(如 selector-class-pattern)強制檢查。
  3. Code Review 時檢視命名合規性。
  4. 建立共用元件庫,統一命名前綴(如 ui-、c-)。
copyright © 萬盛學電腦網 all rights reserved