.nav-primary),而非「長什麼樣」(.blue-bar)或「在哪裡」(.left-column)。.main-content,不使用駝峰、底線、大寫。.m-header、.c-card),避免污染。#header、#footer),Class 用於可復用元件。.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 |
/* 區塊 */
.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優先使用語意標籤,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>
NAMING_CONVENTION.md 文件,列出所有認可的命名模式與禁用模式。stylelint-config-standard + 自定義規則(如 selector-class-pattern)強制檢查。ui-、c-)。