1. 设计系统概述

在现代前端开发中,一个良好的样式设计系统能够确保 UI 的一致性、可维护性和可扩展性。本文将介绍如何构建一个基于 CSS 变量的完整样式设计系统,包括主题切换、组件样式和响应式设计。

1.1 设计原则

原则 说明
一致性 使用统一的色彩、间距、圆角规范
可维护性 CSS 变量集中管理,便于全局修改
可扩展性 模块化组织,支持主题切换
响应式 适配不同屏幕尺寸的设备

1.2 文件结构

styles/
├── variables.css          # CSS 变量定义(设计系统核心)
├── reset.css              # 样式重置
├── main.css               # 主入口文件
├── components/            # 组件样式
│   ├── buttons.css
│   ├── cards.css
│   ├── forms.css
│   └── ...
├── layouts/               # 布局样式
│   ├── grid.css
│   └── responsive.css
├── pages/                 # 页面样式
│   ├── login.css
│   └── dashboard.css
├── themes/                # 主题样式
│   └── dark.css
└── utils/                 # 工具样式
    └── animations.css

2. CSS 变量设计系统

2.1 变量定义(variables.css)

CSS 变量是设计系统的核心,集中管理所有视觉属性。

:root {
  /* 主题颜色 */
  --theme-color: #4CAF50;
  --theme-dark: #388E3C;
  --theme-light: #81C784;
  --theme-color-rgb: 76, 175, 80;
  --theme-text-color: #ffffff;
  
  /* 辅助颜色 */
  --color-primary: #4CAF50;
  --color-secondary: #666666;
  --color-danger: #F44336;
  --color-warning: #FF9800;
  --color-info: #2196F3;
  --color-success: #4CAF50;
  
  /* 背景颜色 */
  --bg-primary: #FFFFFF;
  --bg-secondary: #F5F5F5;
  --bg-tertiary: #f9f9f9;
  --bg-card: #FFFFFF;
  
  /* 文本颜色 */
  --text-primary: #333333;
  --text-secondary: #666666;
  --text-tertiary: #999999;
  
  /* 功能颜色 */
  --success-color: #4CAF50;
  --error-color: #F44336;
  --error-color-rgb: 244, 67, 54;
  --warning-color: #FF9800;
  --info-color: #2196F3;
  
  /* 边框颜色 */
  --border-color: #E0E0E0;
  --border-light: #F0F0F0;
  
  /* 间距系统 */
  --spacing-xs: 4px;
  --spacing-sm: 8px;
  --spacing-md: 16px;
  --spacing-lg: 24px;
  --spacing-xl: 40px;
  
  /* 圆角系统 */
  --border-radius-sm: 4px;
  --border-radius-md: 8px;
  --border-radius-lg: 12px;
  --border-radius-xl: 16px;
  --border-radius-full: 50%;
  
  /* 阴影系统 */
  --shadow-sm: 0 2px 4px rgba(0, 0, 0, 0.05);
  --shadow-md: 0 4px 12px rgba(0, 0, 0, 0.08);
  --shadow-lg: 0 8px 24px rgba(0, 0, 0, 0.12);
  
  /* 过渡效果 */
  --transition: all 0.3s ease;
  
  /* 字体系统 */
  --font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 
                 Oxygen, Ubuntu, Cantarell, 'Open Sans', 'Helvetica Neue', sans-serif;
  --font-size-xs: 12px;
  --font-size-sm: 14px;
  --font-size-md: 16px;
  --font-size-lg: 18px;
  --font-size-xl: 24px;
  --font-size-xxl: 32px;
  
  /* 字体权重 */
  --font-weight-normal: 400;
  --font-weight-medium: 500;
  --font-weight-bold: 700;
  
  /* 布局 */
  --max-width: 1200px;
  --header-height: 64px;
  --sidebar-width: 240px;
}

设计思路

  • 分层管理:颜色、间距、字体等按类别分组
  • 语义化命名:如 --bg-primary 而非 --white,便于主题切换
  • RGB 变量:同时定义 HEX 和 RGB 格式,方便计算透明度

2.2 暗黑模式变量

通过 data-theme 属性切换主题,覆盖默认变量值。

[data-theme="night"] {
  /* 背景颜色 */
  --bg-primary: #121212;
  --bg-secondary: #1e1e1e;
  --bg-tertiary: #2d2d2d;
  --bg-card: #252525;
  
  /* 文本颜色 */
  --text-primary: #e0e0e0;
  --text-secondary: #b0b0b0;
  --text-tertiary: #808080;
  
  /* 边框颜色 */
  --border-color: #333333;
  --border-light: #404040;
  
  /* 阴影 */
  --shadow-sm: 0 2px 4px rgba(0, 0, 0, 0.3);
  --shadow-md: 0 4px 12px rgba(0, 0, 0, 0.4);
  --shadow-lg: 0 8px 24px rgba(0, 0, 0, 0.5);
}

切换原理

// 切换主题时设置属性
document.documentElement.setAttribute('data-theme', 'night');

// 所有使用 CSS 变量的组件自动适应新主题

3. 全局样式重置

3.1 reset.css

统一浏览器默认样式,建立一致的基础。

/* 全局样式重置 */
* {
  margin: 0;
  padding: 0;
  box-sizing: border-box;
}

html, body {
  height: 100%;
  width: 100%;
  font-family: var(--font-family);
  font-size: var(--font-size-lg);
  line-height: 1.5;
  color: var(--text-primary);
  background-color: #f8f9fa;
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
  transition: var(--transition);
}

/* 全局链接样式 */
a {
  color: var(--theme-color);
  text-decoration: none;
  transition: var(--transition);
}

a:hover {
  color: var(--theme-dark);
}

/* 全局标题样式 */
h1, h2, h3, h4, h5, h6 {
  margin-bottom: var(--spacing-md);
  font-weight: 600;
  color: var(--theme-color);
}

h1 { font-size: var(--font-size-xxl); }
h2 { font-size: var(--font-size-xl); }
h3 { font-size: 18px; }
h4 { font-size: var(--font-size-lg); }

/* 全局文本样式 */
p {
  margin-bottom: var(--spacing-md);
  line-height: 1.6;
  color: var(--text-secondary);
}

/* 自定义滚动条 */
::-webkit-scrollbar {
  width: 8px;
  height: 8px;
}

::-webkit-scrollbar-track {
  background: var(--bg-secondary);
  border-radius: var(--border-radius-full);
}

::-webkit-scrollbar-thumb {
  background: linear-gradient(135deg, var(--theme-color), var(--theme-dark));
  border-radius: var(--border-radius-full);
  transition: var(--transition);
}

::-webkit-scrollbar-thumb:hover {
  background: linear-gradient(135deg, var(--theme-dark), var(--theme-color));
}

4. 组件样式设计

4.1 按钮组件(buttons.css)

按钮是交互的核心,设计多种变体满足不同场景。

/* 基础按钮样式 */
.btn {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  gap: var(--spacing-sm);
  padding: 10px 20px;
  border: none;
  border-radius: var(--border-radius-lg);
  font-size: var(--font-size-base);
  font-weight: var(--font-weight-medium);
  cursor: pointer;
  transition: all 0.3s cubic-bezier(0.4, 0, 0.2, 1);
  position: relative;
  overflow: hidden;
  box-shadow: var(--shadow-sm);
}

/* 光泽扫过动画效果 */
.btn::before {
  content: '';
  position: absolute;
  top: 0;
  left: -100%;
  width: 100%;
  height: 100%;
  background: linear-gradient(90deg, transparent, 
              rgba(255, 255, 255, 0.2), transparent);
  transition: left 0.6s ease;
  z-index: 0;
}

.btn:hover::before {
  left: 100%;
}

/* 主要按钮 */
.btn-primary {
  background: linear-gradient(135deg, var(--theme-color), var(--theme-dark));
  color: white;
  border: 1px solid var(--theme-color);
}

.btn-primary:hover {
  transform: translateY(-3px);
  box-shadow: 0 6px 16px rgba(var(--theme-color-rgb), 0.4);
}

/* 次要按钮 */
.btn-secondary {
  background: linear-gradient(135deg, var(--bg-card) 0%, var(--bg-secondary) 100%);
  color: var(--text-primary);
  border: 2px solid var(--border-color);
}

.btn-secondary:hover {
  border-color: var(--theme-color);
  color: var(--theme-color);
  transform: translateY(-3px);
}

/* 危险按钮 */
.btn-danger {
  background: linear-gradient(135deg, var(--bg-card) 0%, var(--bg-secondary) 100%);
  color: var(--error-color);
  border: 2px solid var(--border-color);
}

.btn-danger:hover {
  background: linear-gradient(135deg, var(--error-color), #d32f2f);
  color: white;
  transform: translateY(-3px);
}

/* 收藏按钮 */
.btn-favorite {
  background: none;
  border: none;
  color: var(--text-light);
  cursor: pointer;
  padding: 8px;
  border-radius: var(--border-radius-lg);
  transition: all 0.3s cubic-bezier(0.4, 0, 0.2, 1);
  display: flex;
  align-items: center;
  justify-content: center;
  width: 40px;
  height: 40px;
}

.btn-favorite:hover {
  background-color: rgba(var(--theme-color-rgb), 0.1);
  color: var(--theme-color);
  transform: translateY(-3px) scale(1.1);
}

.btn-favorite.favorited {
  color: var(--theme-color);
  background-color: rgba(var(--theme-color-rgb), 0.1);
}

.btn-favorite.favorited svg {
  fill: var(--theme-color);
  animation: pulse 0.5s ease-in-out;
}

@keyframes pulse {
  0% { transform: scale(1); }
  50% { transform: scale(1.2); }
  100% { transform: scale(1); }
}

设计亮点

  • 光泽扫过效果::before 伪元素实现按钮悬停时的光泽动画
  • 微交互:悬停时轻微上浮(translateY(-3px))和阴影增强
  • 收藏动效:点击时的心形放大动画

4.2 卡片组件(cards.css)

卡片是信息展示的主要容器。

/* 基础卡片 */
.card {
  background: linear-gradient(135deg, var(--bg-primary) 0%, var(--bg-secondary) 100%);
  border-radius: var(--border-radius-xl);
  box-shadow: var(--shadow-md);
  padding: var(--spacing-lg);
  margin-bottom: var(--spacing-lg);
  transition: all 0.3s ease;
  border: 1px solid var(--border-color);
  position: relative;
  overflow: hidden;
}

/* 光泽扫过效果 */
.card::before {
  content: '';
  position: absolute;
  top: -50%;
  left: -50%;
  width: 200%;
  height: 200%;
  background: linear-gradient(45deg, transparent, 
              rgba(var(--theme-color-rgb), 0.1), transparent);
  transform: rotate(45deg);
  transition: all 0.6s ease;
  opacity: 0;
}

.card:hover {
  box-shadow: var(--shadow-lg);
  transform: translateY(-4px);
  border: 1px solid var(--theme-color);
}

.card:hover::before {
  opacity: 1;
  animation: shine 1s ease;
}

@keyframes shine {
  0% { transform: translateX(-100%) rotate(45deg); }
  100% { transform: translateX(100%) rotate(45deg); }
}

/* 大板块卡片 */
.section-card {
  background: linear-gradient(135deg, var(--bg-primary) 0%, var(--bg-secondary) 100%);
  border-radius: var(--border-radius-xl);
  box-shadow: var(--shadow-md);
  overflow: hidden;
  margin-bottom: var(--spacing-lg);
  transition: all 0.3s ease;
  border: 1px solid var(--border-color);
}

.section-card:hover {
  box-shadow: var(--shadow-lg);
  transform: translateY(-2px);
  border-color: var(--theme-color);
}

.section-card__header {
  display: flex;
  align-items: center;
  gap: 16px;
  padding: var(--spacing-lg);
  background: linear-gradient(135deg, var(--bg-tertiary) 0%, var(--bg-secondary) 100%);
  border-bottom: 1px solid var(--border-color);
}

.section-card__icon {
  width: 48px;
  height: 48px;
  border-radius: var(--border-radius-lg);
  background: linear-gradient(135deg, 
              rgba(var(--theme-color-rgb), 0.1) 0%, 
              rgba(var(--theme-color-rgb), 0.05) 100%);
  display: flex;
  align-items: center;
  justify-content: center;
  color: var(--theme-color);
  box-shadow: 0 4px 12px rgba(var(--theme-color-rgb), 0.2);
  transition: all 0.3s ease;
}

.section-card:hover .section-card__icon {
  transform: scale(1.1);
  box-shadow: 0 6px 16px rgba(var(--theme-color-rgb), 0.3);
}

4.3 表单组件(forms.css)

表单是用户输入的主要方式,注重交互体验。

/* 表单组 */
.form__group {
  display: flex;
  flex-direction: column;
  margin-bottom: 20px;
  transition: all 0.3s ease;
}

.form__group:hover {
  transform: translateY(-2px);
}

/* 标签样式 */
.form__label {
  display: block;
  margin-bottom: 10px;
  font-weight: var(--font-weight-medium);
  color: var(--text-primary);
  font-size: var(--font-size-sm);
  position: relative;
  padding-left: 16px;
}

/* 标签前的装饰点 */
.form__label::before {
  content: '';
  position: absolute;
  left: 0;
  top: 50%;
  transform: translateY(-50%);
  width: 8px;
  height: 8px;
  border-radius: 50%;
  background: linear-gradient(135deg, var(--theme-color), var(--theme-light));
  box-shadow: 0 2px 6px rgba(var(--theme-color-rgb), 0.3);
}

/* 输入框 */
.form__input {
  box-sizing: border-box;
  height: 48px;
  padding: 0 16px;
  border: 2px solid var(--border-color);
  border-radius: var(--border-radius-lg);
  font-size: var(--font-size-sm);
  transition: all 0.3s ease;
  width: 100%;
  background: linear-gradient(135deg, var(--bg-primary) 0%, var(--bg-secondary) 100%);
  color: var(--text-primary);
}

.form__input:focus {
  outline: none;
  border-color: var(--theme-color);
  box-shadow: 0 0 0 4px rgba(var(--theme-color-rgb), 0.1);
  transform: translateY(-2px);
}

.form__input:hover {
  border-color: var(--theme-color);
}

/* 下拉选择框 */
select.form__input {
  appearance: none;
  background: linear-gradient(135deg, var(--bg-primary) 0%, var(--bg-secondary) 100%);
  cursor: pointer;
  padding: 0 52px 0 16px;
}

/* 自定义下拉箭头 */
select.form__input::after {
  content: '';
  position: absolute;
  right: 16px;
  top: 50%;
  transform: translateY(-50%);
  width: 18px;
  height: 18px;
  background-image: url("data:image/svg+xml,...");
  background-repeat: no-repeat;
  pointer-events: none;
}

/* 文本域 */
.form__textarea {
  box-sizing: border-box;
  padding: 16px;
  border: 2px solid var(--border-color);
  border-radius: var(--border-radius-lg);
  font-size: var(--font-size-base);
  transition: all 0.3s ease;
  width: 100%;
  background: linear-gradient(135deg, var(--bg-primary) 0%, var(--bg-secondary) 100%);
  color: var(--text-primary);
  resize: vertical;
  min-height: 120px;
}

.form__textarea:focus {
  outline: none;
  border-color: var(--theme-color);
  box-shadow: 0 0 0 4px rgba(var(--theme-color-rgb), 0.1);
  transform: translateY(-2px);
}

/* 复选框 */
.checkbox__container {
  margin: var(--spacing-md) 0;
  display: flex;
  align-items: center;
  gap: 12px;
  padding: 16px;
  background: linear-gradient(135deg, var(--bg-tertiary) 0%, var(--bg-secondary) 100%);
  border-radius: var(--border-radius-lg);
  transition: all 0.3s ease;
  border: 1px solid var(--border-color);
  cursor: pointer;
}

.checkbox__container:hover {
  transform: translateY(-2px);
  box-shadow: var(--shadow-sm);
  border-color: var(--theme-color);
}

.checkbox__container input[type="checkbox"] {
  width: 20px;
  height: 20px;
  accent-color: var(--theme-color);
  cursor: pointer;
  transition: all 0.3s ease;
}

.checkbox__container input[type="checkbox"]:checked {
  transform: scale(1.1);
  box-shadow: 0 0 0 3px rgba(var(--theme-color-rgb), 0.2);
}

5. 夜间模式实现

5.1 主题切换原理

通过 data-theme 属性控制主题,CSS 变量自动适配。

/* 夜间模式覆盖样式 */
[data-theme="night"] {
  color-scheme: dark;
}

[data-theme="night"] html, 
[data-theme="night"] body {
  color: #f0f0f0;
  background-color: #1e1e1e;
}

/* 表单元素夜间模式 */
[data-theme="night"] .form__input {
  background: linear-gradient(135deg, #2d2d2d 0%, #252525 100%);
  border-color: #404040;
  color: #f0f0f0;
}

[data-theme="night"] .form__input:focus {
  border-color: var(--theme-color);
  box-shadow: 0 0 0 3px rgba(var(--theme-color-rgb), 0.2);
}

/* 按钮夜间模式 */
[data-theme="night"] .btn-secondary {
  background: linear-gradient(135deg, #2d2d2d 0%, #252525 100%);
  color: #f0f0f0;
  border-color: #404040;
}

[data-theme="night"] .btn-secondary:hover {
  border-color: var(--theme-color);
  color: var(--theme-color);
}

/* 卡片夜间模式 */
[data-theme="night"] .card {
  background: linear-gradient(135deg, #252525 0%, #1e1e1e 100%);
  border-color: #333333;
}

5.2 JavaScript 主题切换

// theme.js
export const ThemeType = {
  DAY: 'day',
  NIGHT: 'night'
}

// 设置主题
export const setTheme = (theme) => {
  localStorage.setItem('theme', theme)
  document.documentElement.setAttribute('data-theme', theme)
}

// 获取当前主题
export const getCurrentTheme = () => {
  return localStorage.getItem('theme') || ThemeType.DAY
}

// 切换主题
export const toggleTheme = () => {
  const currentTheme = getCurrentTheme()
  const newTheme = currentTheme === ThemeType.DAY ? ThemeType.NIGHT : ThemeType.DAY
  setTheme(newTheme)
  return newTheme
}

// 初始化主题
export const initTheme = () => {
  const savedTheme = localStorage.getItem('theme') || ThemeType.DAY
  document.documentElement.setAttribute('data-theme', savedTheme)
}

6. 响应式设计

6.1 断点设计

/* 响应式断点 */
/* 大屏桌面:默认样式 */

/* 平板 */
@media (max-width: 768px) {
  .grid-cols-2, .grid-cols-3, .grid-cols-4 {
    grid-template-columns: 1fr;
  }
  
  .card {
    padding: 20px;
  }
  
  h1 { font-size: 20px; }
  h2 { font-size: 18px; }
  
  /* 表单布局调整 */
  .form__grid {
    grid-template-columns: 1fr;
    gap: var(--spacing-md);
  }
  
  /* 多列布局改为单列 */
  .layout__two-column,
  .layout__three-column {
    flex-direction: column;
    gap: var(--spacing-md);
  }
}

/* 手机 */
@media (max-width: 480px) {
  .card {
    padding: var(--spacing-sm);
    border-radius: var(--border-radius-lg);
  }
  
  .form__input {
    height: 44px;
    padding: 0 14px;
    font-size: var(--font-size-sm);
  }
  
  /* 表单项垂直排列 */
  .food__item,
  .exercise__item {
    flex-direction: column;
    align-items: stretch;
    gap: 8px;
  }
  
  /* 按钮全宽 */
  .form__submit-container {
    flex-direction: column;
    align-items: stretch;
  }
  
  .form__submit-container button {
    width: 100%;
  }
}

6.2 响应式工具类

/* 隐藏/显示工具类 */
.hide-mobile { display: block; }
.hide-desktop { display: none; }

@media (max-width: 768px) {
  .hide-mobile { display: none; }
  .hide-desktop { display: block; }
}

/* 弹性布局工具类 */
.flex { display: flex; }
.flex-col { flex-direction: column; }
.flex-wrap { flex-wrap: wrap; }
.items-center { align-items: center; }
.justify-between { justify-content: space-between; }
.gap-sm { gap: var(--spacing-sm); }
.gap-md { gap: var(--spacing-md); }
.gap-lg { gap: var(--spacing-lg); }

/* 网格布局 */
.grid { display: grid; }
.grid-cols-2 { grid-template-columns: repeat(2, 1fr); }
.grid-cols-3 { grid-template-columns: repeat(3, 1fr); }
.grid-cols-4 { grid-template-columns: repeat(4, 1fr); }

7. 动画效果

7.1 基础动画

/* 动画定义 */
@keyframes slideIn {
  from {
    transform: translateX(100%);
    opacity: 0;
  }
  to {
    transform: translateX(0);
    opacity: 1;
  }
}

@keyframes slideUp {
  from {
    transform: translateY(100%);
    opacity: 0;
  }
  to {
    transform: translateY(0);
    opacity: 1;
  }
}

@keyframes fadeIn {
  from {
    opacity: 0;
    transform: translateY(-10px);
  }
  to {
    opacity: 1;
    transform: translateY(0);
  }
}

@keyframes heartBeat {
  0% { transform: scale(1); }
  50% { transform: scale(1.3); }
  100% { transform: scale(1); }
}

@keyframes spin {
  to { transform: rotate(360deg); }
}

/* 光泽扫过动画 */
@keyframes shine {
  0% { transform: translateX(-100%) rotate(45deg); }
  100% { transform: translateX(100%) rotate(45deg); }
}

7.2 使用示例

/* Toast 提示动画 */
.toast {
  animation: slideIn 0.3s ease;
}

/* 模态框动画 */
.modal {
  animation: fadeIn 0.3s ease;
}

/* 加载动画 */
.loading-spinner {
  animation: spin 1s linear infinite;
}

/* 收藏心跳动画 */
.favorite-btn.active svg {
  animation: heartBeat 0.5s ease-in-out;
}

8. 最佳实践

8.1 CSS 变量命名规范

--color-primary: #4CAF50;
--bg-card: #FFFFFF;
--text-secondary: #666666;
--spacing-lg: 24px;
--border-radius-md: 8px;

8.2 样式组织原则

  1. 单一职责:每个 CSS 文件只负责一类组件
  2. 避免深层嵌套:最多 3 层嵌套
  3. 使用 BEM 命名.block__element--modifier
  4. 优先使用变量:颜色、间距等使用 CSS 变量

8.3 性能优化

/* 使用 transform 和 opacity 进行动画 */
.card:hover {
  transform: translateY(-4px);  /* GPU 加速 */
  opacity: 0.9;
}

/* will-change 提示浏览器优化 */
.animation-heavy {
  will-change: transform;
}

更多推荐