CSS class命名规范

72 阅读4分钟

CSS class命名规范

分类具体命名命名说明命名规范
基础结构类.container容器常规
.container-fluid流体容器(全宽)常规
.wrapper包裹层常规
.inner内部容器常规
.outer外部容器常规
.row行容器常规
.col列容器常规
.grid网格容器常规
.cell网格单元常规
布局类.header页头常规
.footer页脚常规
.main主内容区常规
.sidebar侧边栏常规
.aside附加内容区常规
.content内容区常规
.section区块常规
.article文章常规
导航类.nav导航常规/BEM
.navbar导航栏常规
.menu菜单常规/BEM
.tabs标签页常规
.breadcrumb面包屑导航常规
.pagination分页常规
.dropdown下拉菜单常规
组件类.btn按钮常规/BEM
.btn--primary主要按钮BEM修饰符
.btn--secondary次要按钮BEM修饰符
.btn--success成功按钮BEM修饰符
.btn--danger危险按钮BEM修饰符
.btn--warning警告按钮BEM修饰符
.btn--info信息按钮BEM修饰符
.btn--link链接按钮BEM修饰符
.card卡片常规/BEM
.card--featured特色卡片BEM修饰符
.form表单常规
.form-group表单组常规
.form-control表单控件常规
.input输入框常规
.input-text文本输入框常规
.input-password密码输入框常规
.select下拉选择框常规
.textarea文本域常规
.checkbox复选框常规
.radio单选框常规
.label标签常规
.icon图标常规
.badge徽章常规
.alert提示框常规
.tooltip工具提示常规
.popover弹出框常规
.modal模态框常规
.list列表常规
.list-item列表项常规
.table表格常规
.table-row表格行常规
.table-cell表格单元格常规
.notification通知常规
.panel面板常规
状态类.active激活状态常规
.is-active激活状态(常用前缀)SMACSS
.inactive非激活状态常规
.disabled禁用状态常规
.is-disabled禁用状态(常用前缀)SMACSS
.enabled启用状态常规
.hidden隐藏状态常规
.is-hidden隐藏状态(常用前缀)SMACSS
.visible可见状态常规
.is-visible可见状态(常用前缀)SMACSS
.show显示状态常规
.hide隐藏状态常规
.open展开状态常规
.close关闭状态常规
.collapsed折叠状态常规
.expanded展开状态常规
.is-expanded展开状态(常用前缀)SMACSS
.loading加载状态常规
.is-loading加载状态(常用前缀)SMACSS
.error错误状态常规
.has-error错误状态(常用前缀)SMACSS
.success成功状态常规
.has-success成功状态(常用前缀)SMACSS
.warning警告状态常规
.info信息状态常规
.is-invalid无效状态SMACSS
.is-selected选中状态SMACSS
工具类.text-center文本居中常规/Atomic CSS
.text-left文本左对齐常规
.text-right文本右对齐常规
.text-justify文本两端对齐常规
.text-uppercase文本大写常规
.text-lowercase文本小写常规
.text-capitalize文本首字母大写常规
.font-bold粗体文本常规
.font-light轻量文本常规
.font-italic斜体文本常规
.font-normal正常文本常规
.mt-4上边距4单位Atomic CSS
.mb-3下边距3单位Atomic CSS
.pt-2上内边距2单位Atomic CSS
.pb-1下内边距1单位Atomic CSS
.u-mt-20上边距20pxAtomic CSS
.pull-left左浮动常规
.pull-right右浮动常规
.clearfix清除浮动常规
.u-clearfix清除浮动(工具类)常规
.sr-only屏幕阅读器专用常规
.u-ellipsis文本溢出省略常规
.display-flex弹性布局Atomic CSS
.position-relative相对定位Atomic CSS
主题类.t-dark暗黑主题常规
.t-light明亮主题常规
.theme-blue蓝色主题常规
文本类.text文本常规
.text-primary主要文本常规
.text-secondary次要文本常规
.text-success成功文本常规
.text-danger危险文本常规
.text-warning警告文本常规
.text-info信息文本常规
.text-muted弱化文本常规
尺寸类.xs超小尺寸常规
.sm小尺寸常规
.md中等尺寸常规
.lg大尺寸常规
.xl超大尺寸常规
.full全尺寸常规
.half半尺寸常规
.auto自动尺寸常规
位置类.top顶部常规
.bottom底部常规
.left左侧常规
.right右侧常规
.center居中常规
.middle中间常规
.start起始位置常规
.end结束位置常规
.fixed固定定位常规
.absolute绝对定位常规
.relative相对定位常规
.static静态定位常规

关键说明:

  1. 命名规范类型

    • BEMblock__element--modifier 结构(如 .menu__item--active
    • SMACSS:状态类常用 is-/has- 前缀(如 .is-active
    • Atomic CSS:一个class对应单一CSS属性(如 .mt-4
    • 常规:无特定方法论的标准命名
  2. 使用建议

    • 中小项目:BEM + 状态类(.is-active
    • 大型项目:CSS Modules/SCSS + SMACSS分层
    • 避免使用样式描述(如 .red-text)而用功能描述(如 .error-message
    • 命名深度不超过2级(避免 .block__element__subelement