核心原則
| 項目 | CSS 中 | HTML 屬性值中 | 備註 |
類別選擇器 .class | ✅ 大小寫敏感 | ✅ 大小寫敏感 | HTML class 屬性值區分大小寫 |
ID 選擇器 #id | ✅ 大小寫敏感 | ✅ 大小寫敏感 | HTML id 屬性值區分大小寫 |
標籤選擇器 div | ❌ 不敏感 (HTML) | ❌ 不敏感 (HTML) | HTML 標籤名不區分大小寫 |
標籤選擇器 div | ✅ 敏感 (XML/XHTML) | ✅ 敏感 (XML/XHTML) | XML/XHTML 標籤名區分大小寫 |
屬性名 [type] | ❌ 不敏感 (HTML) | ❌ 不敏感 | HTML 屬性名不區分 |
屬性值 [type="text"] | ✅ 敏感 | ✅ 敏感 | 屬性值區分大小寫 |
| CSS 屬性名 | ❌ 不敏感 | — | COLOR = color |
| CSS 關鍵字值 | ❌ 不敏感 | — | RED = red,但字串值 (字體名、url) 敏感 |
HTML vs XHTML 差異
內容
內容
/* 以上相同,但 CSS 中 .Box ≠ .box,#Main ≠ #main */
內容
/* CSS 必須 .Box { } #Main { } */
實務命名規範建議
全小寫 + 連字符 (Kebab-case) — 業界標準
.btn-primary { }
#main-header { }
[data-user-role="admin"] { }
優點:跨環境一致、無大小写陷阱、可讀性佳、符合 CSS/HTML/JS 慣例。
避免的命名模式
| 反模式 | 問題 | 修正 |
.redText (camelCase) | CSS 類選擇器區分大小寫,易打錯 | .red-text |
.RedText (PascalCase) | 同上,且像元件類名 | .red-text |
#MainContent | ID 區分大小寫,JS 選取易出錯 | #main-content |
.box_1of3 (底線混雜) | 不一致,部分工具不支援 | .box-1-of-3 |
屬性選擇器大小寫控制 (CSS4)
[class="box"] /* 預設:區分大小寫 */
[class="box" i] /* i 標誌:不區分大小寫 (支援度佳) */
[class="box" s] /* s 標誌:區分大小寫 (明確指定) */
/* 實用案例:不區分大小寫匹配類別 */
[class*="btn" i] { } /* 匹配 .btn, .Btn, .BTN, .BtnPrimary 等 */
字體名稱與字串值
font-family: "Microsoft JhengHei", "PingFang TC", sans-serif;
/* 字體名稱必須完全匹配系統字體名稱大小寫 */
@import url("./styles.css"); /* URL 路徑在 Linux 伺服器區分大小寫 */
background: url("../Img/bg.png"); /* 檔案路徑大小寫需與實體檔案一致 */
團隊規範檢查清單
- ✅ 所有 class/id 使用 kebab-case 全小寫
- ✅ CSS 屬性名、關鍵字全小寫
- ✅ 字體名稱、檔案路徑、URL 確認實際大小寫
- ✅ 專案配置 Stylelint 強制執行命名規範
- ✅ 代碼審查檢查大小寫一致性
常見除錯場景
/* HTML */
...
/* CSS - 錯誤:大小寫不匹配 */
.usercard { color: red; } ❌ 不生效
/* CSS - 正確 */
.UserCard { color: red; } ✅ 生效
/* 或 */
[class="UserCard" i] { color: red; } ✅ 生效 (不區分大小寫) */