Vue 3 前端样式设计系统
·
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 样式组织原则
- 单一职责:每个 CSS 文件只负责一类组件
- 避免深层嵌套:最多 3 层嵌套
- 使用 BEM 命名:
.block__element--modifier - 优先使用变量:颜色、间距等使用 CSS 变量
8.3 性能优化
/* 使用 transform 和 opacity 进行动画 */
.card:hover {
transform: translateY(-4px); /* GPU 加速 */
opacity: 0.9;
}
/* will-change 提示浏览器优化 */
.animation-heavy {
will-change: transform;
}
更多推荐


所有评论(0)