萬盛學電腦網

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

CSS 類別與 ID 命名規範:常用語意化關鍵字表(容器、導航、內容、側邊欄、表單、狀態等)

CSS 類別與 ID 命名規範:統一團隊語言的關鍵字對照表

專案多人協作時,統一的命名關鍵字能大幅降低溝通成本、避免衝突、提升代碼可讀性。以下整理業界通用的語意化命名對照表,建議納入團隊規範文件。

佈局結構層

語意推薦命名備註
整體容器container, wrap, box最外層包裹,通常配合 max-width 置中
頁首header, hd
頁尾footer, ft
主內容區main, main-body, content<main> 元素可直接用
側邊欄sidebar, side, aside
欄位/分欄col, column, col-1of3, col-2of3網格系統專用
頁面區塊section, block, module

導航相關

語意推薦命名備註
主導航nav, main-nav, primary-nav
子導航sub-nav, secondary-nav
頂部導航top-nav, header-nav
麵包屑breadcrumb, crumb, current-path
分頁pagination, pager, page-nav
標籤頁tab, tab-nav, tab-list
選單/下拉menu, dropdown, dropmenu

功能區塊

語意推薦命名備註
Logo/品牌logo, brand, site-logo
大幅廣告/橫幅banner, hero, banner-img
搜尋區塊search, search-form
搜尋關鍵字輸入keyword, search-input, q
搜尋範圍/分類range, category, filter
標籤/標題tag, tag-title, tag-content, tag-current
標題區塊title, heading, hd
內容區塊content, cnt, body, entry
列表容器list, items, feed, stream
列表項目item, list-item, entry
卡片元件card, tile, panel
媒體物件media, media-object圖文混排經典模式

表單與互動

語意推薦命名備註
表單容器form, form-wrapper
輸入框群組form-group, field, input-group
標籤label, field-label
輸入控件input, field-input, control
提示/錯誤hint, help, error, message, feedback
按鈕btn, button, action修飾:btn-primary, btn-secondary, btn-lg
圖示icon, ico修飾:icon-search, icon-user
彈窗/模態框modal, dialog, popup, overlay
登入/註冊login, register, signup, signin

狀態與修飾(BEM --modifier / SUIT is-/has-)

語意推薦命名備註
當前/激活current, active, is-active, --active
禁用disabled, is-disabled, --disabled
載入中loading, is-loading, --loading
隱藏/顯示hidden, visible, is-hidden, --hidden
展開/摺疊expanded, collapsed, is-open, --open
選中/勾選selected, checked, is-selected
錯誤/警告/成功error, warning, success, is-error, --error
首個/最後first, last, --first, --last
奇數/偶數列odd, even, --odd, --even或用 :nth-child 偽類

命名規範鐵律

  1. 全小寫 + 連字號:.main-nav(非 .mainNav、.main_nav)。
  2. 語意化 > 表象化:.btn-primary(主要動作)而非 .btn-blue;.sidebar 而非 .left-col。
  3. BEM 結構:.block__element--modifier(雙底線元素、雙連字號修飾)。
  4. 避免縮寫造成歧義:.btn 可,.b 不可;.nav-item 可,.ni 不可。
  5. ID 僅用於唯一錨點/表單關聯/頁面大區塊,元件樣式全用 Class。
  6. JS 掛鉤專用前綴:.js- 或 data- 屬性,**絕不**在 CSS 中定義 .js-* 樣式。
  7. 文件化 + Lint 強制:寫入 NAMING.md,Stylelint selector-class-pattern: "^[a-z][a-z0-9]*(-[a-z0-9]+)*(__[a-z0-9]+(-[a-z0-9]+)*)?(--[a-z0-9]+(-[a-z0-9]+)*)?$"。

統一命名,是團隊協作效率的隱形乘數器。

copyright © 萬盛學電腦網 all rights reserved