第7章：CSS 进阶专题

深入现代 CSS 的高级特性，掌握设计令牌、容器查询、:has() 选择器、动画优化等前沿技术。这些特性不仅能提升开发效率，更能为构建现代化的用户界面提供强大支持。

📋 本章内容

设计令牌与主题系统
容器查询驱动组件自适应
:has() 选择器解耦交互状态
高性能动画与微交互
CSS 工程实践
实战练习

🎯 学习目标

掌握设计令牌系统的构建方法
理解容器查询的工作原理和应用场景
学会使用 :has() 选择器优化交互设计
掌握高性能动画的实现技巧
建立现代 CSS 工程化思维

🎨 设计令牌与主题系统

设计令牌基础

设计令牌（Design Tokens）是设计系统的原子单位，它们定义了颜色、字体、间距等设计元素的值：

/* 基础设计令牌 */
:root {
  /* 颜色系统 */
  --color-primary-50: #e8f5e8;
  --color-primary-100: #c8e6c9;
  --color-primary-200: #a5d6a7;
  --color-primary-300: #81c784;
  --color-primary-400: #66bb6a;
  --color-primary-500: #4caf50;
  --color-primary-600: #43a047;
  --color-primary-700: #388e3c;
  --color-primary-800: #2e7d32;
  --color-primary-900: #1b5e20;
  
  /* 语义化颜色 */
  --color-success: var(--color-primary-500);
  --color-warning: #ff9800;
  --color-error: #f44336;
  --color-info: #2196f3;
  
  /* 中性色 */
  --color-gray-50: #fafafa;
  --color-gray-100: #f5f5f5;
  --color-gray-200: #eeeeee;
  --color-gray-300: #e0e0e0;
  --color-gray-400: #bdbdbd;
  --color-gray-500: #9e9e9e;
  --color-gray-600: #757575;
  --color-gray-700: #616161;
  --color-gray-800: #424242;
  --color-gray-900: #212121;
  
  /* 间距系统 */
  --space-0: 0;
  --space-1: 0.25rem;   /* 4px */
  --space-2: 0.5rem;    /* 8px */
  --space-3: 0.75rem;   /* 12px */
  --space-4: 1rem;      /* 16px */
  --space-5: 1.25rem;   /* 20px */
  --space-6: 1.5rem;    /* 24px */
  --space-8: 2rem;      /* 32px */
  --space-10: 2.5rem;   /* 40px */
  --space-12: 3rem;     /* 48px */
  --space-16: 4rem;     /* 64px */
  --space-20: 5rem;     /* 80px */
  
  /* 字体系统 */
  --font-family-sans: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
  --font-family-mono: 'SF Mono', Monaco, 'Cascadia Code', 'Roboto Mono', Consolas, monospace;
  
  --font-size-xs: 0.75rem;    /* 12px */
  --font-size-sm: 0.875rem;   /* 14px */
  --font-size-base: 1rem;     /* 16px */
  --font-size-lg: 1.125rem;   /* 18px */
  --font-size-xl: 1.25rem;    /* 20px */
  --font-size-2xl: 1.5rem;    /* 24px */
  --font-size-3xl: 1.875rem;  /* 30px */
  --font-size-4xl: 2.25rem;   /* 36px */
  
  --font-weight-light: 300;
  --font-weight-normal: 400;
  --font-weight-medium: 500;
  --font-weight-semibold: 600;
  --font-weight-bold: 700;
  
  /* 行高 */
  --line-height-tight: 1.25;
  --line-height-normal: 1.5;
  --line-height-relaxed: 1.75;
  
  /* 圆角系统 */
  --radius-none: 0;
  --radius-sm: 0.125rem;   /* 2px */
  --radius-md: 0.375rem;   /* 6px */
  --radius-lg: 0.5rem;     /* 8px */
  --radius-xl: 0.75rem;    /* 12px */
  --radius-2xl: 1rem;      /* 16px */
  --radius-full: 9999px;
  
  /* 阴影系统 */
  --shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
  --shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);
  --shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05);
  --shadow-xl: 0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 10px 10px -5px rgba(0, 0, 0, 0.04);
  
  /* 过渡系统 */
  --transition-fast: 150ms ease;
  --transition-normal: 250ms ease;
  --transition-slow: 350ms ease;
  
  /* 层级系统 */
  --z-dropdown: 1000;
  --z-sticky: 1020;
  --z-fixed: 1030;
  --z-modal-backdrop: 1040;
  --z-modal: 1050;
  --z-popover: 1060;
  --z-tooltip: 1070;
}

主题切换系统

/* 浅色主题 */
:root {
  --color-bg-primary: var(--color-gray-50);
  --color-bg-secondary: #ffffff;
  --color-bg-tertiary: var(--color-gray-100);
  
  --color-text-primary: var(--color-gray-900);
  --color-text-secondary: var(--color-gray-600);
  --color-text-tertiary: var(--color-gray-500);
  
  --color-border-primary: var(--color-gray-200);
  --color-border-secondary: var(--color-gray-300);
}

/* 深色主题 */
:root[data-theme="dark"] {
  --color-bg-primary: var(--color-gray-900);
  --color-bg-secondary: var(--color-gray-800);
  --color-bg-tertiary: var(--color-gray-700);
  
  --color-text-primary: var(--color-gray-100);
  --color-text-secondary: var(--color-gray-300);
  --color-text-tertiary: var(--color-gray-400);
  
  --color-border-primary: var(--color-gray-700);
  --color-border-secondary: var(--color-gray-600);
}

/* 高对比度主题 */
:root[data-theme="high-contrast"] {
  --color-bg-primary: #000000;
  --color-bg-secondary: #ffffff;
  --color-text-primary: #ffffff;
  --color-text-secondary: #000000;
  --color-border-primary: #ffffff;
}

组件令牌系统

/* 按钮组件令牌 */
.btn {
  /* 基础样式 */
  --btn-padding-x: var(--space-4);
  --btn-padding-y: var(--space-2);
  --btn-font-size: var(--font-size-sm);
  --btn-font-weight: var(--font-weight-medium);
  --btn-border-radius: var(--radius-md);
  --btn-border-width: 1px;
  --btn-transition: var(--transition-fast);
  
  /* 默认样式 */
  padding: var(--btn-padding-y) var(--btn-padding-x);
  font-size: var(--btn-font-size);
  font-weight: var(--btn-font-weight);
  border-radius: var(--btn-border-radius);
  border: var(--btn-border-width) solid transparent;
  transition: all var(--btn-transition);
  cursor: pointer;
}

/* 按钮变体 */
.btn--primary {
  --btn-bg: var(--color-primary-500);
  --btn-color: #ffffff;
  --btn-border-color: var(--color-primary-500);
  
  background-color: var(--btn-bg);
  color: var(--btn-color);
  border-color: var(--btn-border-color);
}

.btn--primary:hover {
  --btn-bg: var(--color-primary-600);
  --btn-border-color: var(--color-primary-600);
}

.btn--secondary {
  --btn-bg: transparent;
  --btn-color: var(--color-primary-500);
  --btn-border-color: var(--color-primary-500);
  
  background-color: var(--btn-bg);
  color: var(--btn-color);
  border-color: var(--btn-border-color);
}

/* 按钮尺寸 */
.btn--sm {
  --btn-padding-x: var(--space-3);
  --btn-padding-y: var(--space-1);
  --btn-font-size: var(--font-size-xs);
}

.btn--lg {
  --btn-padding-x: var(--space-6);
  --btn-padding-y: var(--space-3);
  --btn-font-size: var(--font-size-base);
}

📱 容器查询驱动组件自适应

容器查询基础

容器查询允许组件根据自身尺寸而不是视口尺寸来调整样式：

/* 定义容器上下文 */
.card {
  container-type: inline-size;
  /* 或者使用简写 */
  container: inline-size;
}

/* 基于容器宽度的样式 */
@container (min-width: 300px) {
  .card__content {
    display: flex;
    gap: var(--space-4);
  }
  
  .card__image {
    flex: 0 0 120px;
  }
  
  .card__text {
    flex: 1;
  }
}

@container (min-width: 500px) {
  .card__content {
    flex-direction: row;
  }
  
  .card__title {
    font-size: var(--font-size-lg);
  }
}

@container (min-width: 800px) {
  .card__content {
    gap: var(--space-6);
  }
  
  .card__image {
    flex: 0 0 200px;
  }
  
  .card__title {
    font-size: var(--font-size-xl);
  }
}

容器查询单位

/* 容器查询单位 */
.responsive-text {
  /* 容器宽度的 10% */
  font-size: 10cqw;
  
  /* 容器高度的 5% */
  padding: 5cqh;
  
  /* 容器内联尺寸的较小值 */
  margin: 2cqmin;
  
  /* 容器内联尺寸的较大值 */
  border-radius: 4cqmax;
}

/* 实际应用示例 */
.card {
  container-type: inline-size;
  padding: var(--space-4);
}

.card__title {
  /* 根据容器宽度调整字体大小 */
  font-size: clamp(1rem, 5cqw, 2rem);
}

.card__content {
  /* 根据容器宽度调整间距 */
  gap: clamp(var(--space-2), 3cqw, var(--space-6));
}

复杂容器查询示例

/* 产品卡片组件 */
.product-card {
  container-type: inline-size;
  display: flex;
  flex-direction: column;
  border: 1px solid var(--color-border-primary);
  border-radius: var(--radius-lg);
  overflow: hidden;
  transition: var(--transition-normal);
}

.product-card:hover {
  box-shadow: var(--shadow-lg);
  transform: translateY(-2px);
}

/* 小尺寸：垂直布局 */
@container (max-width: 300px) {
  .product-card__image {
    aspect-ratio: 1;
  }
  
  .product-card__content {
    padding: var(--space-3);
  }
  
  .product-card__title {
    font-size: var(--font-size-sm);
    margin-bottom: var(--space-2);
  }
  
  .product-card__price {
    font-size: var(--font-size-lg);
    font-weight: var(--font-weight-bold);
  }
}

/* 中等尺寸：水平布局 */
@container (min-width: 301px) and (max-width: 600px) {
  .product-card {
    flex-direction: row;
  }
  
  .product-card__image {
    flex: 0 0 150px;
    aspect-ratio: 1;
  }
  
  .product-card__content {
    flex: 1;
    padding: var(--space-4);
    display: flex;
    flex-direction: column;
    justify-content: space-between;
  }
  
  .product-card__title {
    font-size: var(--font-size-base);
    margin-bottom: var(--space-3);
  }
  
  .product-card__actions {
    margin-top: auto;
  }
}

/* 大尺寸：增强布局 */
@container (min-width: 601px) {
  .product-card {
    flex-direction: column;
  }
  
  .product-card__image {
    aspect-ratio: 16/9;
  }
  
  .product-card__content {
    padding: var(--space-6);
  }
  
  .product-card__title {
    font-size: var(--font-size-lg);
    margin-bottom: var(--space-4);
  }
  
  .product-card__description {
    display: block;
    color: var(--color-text-secondary);
    margin-bottom: var(--space-4);
  }
  
  .product-card__actions {
    display: flex;
    gap: var(--space-3);
  }
}

🎯 :has() 选择器解耦交互状态

:has() 选择器基础

:has() 选择器允许根据子元素状态来设置父元素样式：

/* 基础用法 */
.field:has(input:focus) {
  border-color: var(--color-primary-500);
  box-shadow: 0 0 0 2px rgba(76, 175, 80, 0.2);
}

.field:has(input:invalid) {
  border-color: var(--color-error);
}

.field:has(input:valid) {
  border-color: var(--color-success);
}

/* 复杂选择器 */
.card:has(.card__image:hover) {
  transform: translateY(-4px);
  box-shadow: var(--shadow-xl);
}

.nav li:has(> a[aria-current="page"]) {
  background-color: var(--color-primary-500);
  color: white;
}

.form-group:has(.error-message) {
  margin-bottom: var(--space-6);
}

.form-group:has(.error-message) input {
  border-color: var(--color-error);
}

交互状态优化

/* 卡片交互状态 */
.card {
  transition: var(--transition-normal);
  border: 1px solid var(--color-border-primary);
  border-radius: var(--radius-lg);
  overflow: hidden;
}

/* 悬停状态 */
.card:has(.card__image:hover) {
  transform: translateY(-2px);
  box-shadow: var(--shadow-md);
}

.card:has(.card__button:hover) {
  border-color: var(--color-primary-500);
}

/* 焦点状态 */
.card:has(.card__button:focus) {
  outline: 2px solid var(--color-primary-500);
  outline-offset: 2px;
}

/* 激活状态 */
.card:has(.card__button:active) {
  transform: translateY(0);
  box-shadow: var(--shadow-sm);
}

/* 禁用状态 */
.card:has(.card__button:disabled) {
  opacity: 0.6;
  cursor: not-allowed;
}

表单验证状态

/* 表单字段状态 */
.form-field {
  position: relative;
  margin-bottom: var(--space-4);
}

.form-field__input {
  width: 100%;
  padding: var(--space-3);
  border: 1px solid var(--color-border-primary);
  border-radius: var(--radius-md);
  transition: var(--transition-fast);
}

/* 焦点状态 */
.form-field:has(.form-field__input:focus) {
  .form-field__label {
    color: var(--color-primary-500);
  }
}

.form-field:has(.form-field__input:focus) .form-field__input {
  border-color: var(--color-primary-500);
  box-shadow: 0 0 0 2px rgba(76, 175, 80, 0.2);
}

/* 验证状态 */
.form-field:has(.form-field__input:valid) .form-field__input {
  border-color: var(--color-success);
}

.form-field:has(.form-field__input:invalid) .form-field__input {
  border-color: var(--color-error);
}

/* 错误状态 */
.form-field:has(.form-field__error) {
  margin-bottom: var(--space-6);
}

.form-field:has(.form-field__error) .form-field__input {
  border-color: var(--color-error);
}

.form-field:has(.form-field__error) .form-field__label {
  color: var(--color-error);
}

/* 成功状态 */
.form-field:has(.form-field__success) .form-field__input {
  border-color: var(--color-success);
}

.form-field:has(.form-field__success) .form-field__label {
  color: var(--color-success);
}

⚡ 高性能动画与微交互

动画性能优化

/* 只使用 transform 和 opacity 进行动画 */
.optimized-animation {
  will-change: transform, opacity;
  transform: translateZ(0); /* 强制硬件加速 */
}

/* 好的动画属性 */
.good-animation {
  transition: transform 0.3s ease, opacity 0.3s ease;
}

.good-animation:hover {
  transform: translateY(-4px) scale(1.02);
  opacity: 0.9;
}

/* 避免的动画属性 */
.bad-animation {
  transition: width 0.3s ease, height 0.3s ease; /* 会触发布局 */
}

/* 动画结束后移除 will-change */
.optimized-animation.animation-complete {
  will-change: auto;
}

微交互设计

/* 按钮微交互 */
.btn {
  position: relative;
  overflow: hidden;
  transition: var(--transition-fast);
}

.btn::before {
  content: '';
  position: absolute;
  top: 50%;
  left: 50%;
  width: 0;
  height: 0;
  background: rgba(255, 255, 255, 0.3);
  border-radius: 50%;
  transform: translate(-50%, -50%);
  transition: width 0.6s, height 0.6s;
}

.btn:active::before {
  width: 300px;
  height: 300px;
}

/* 卡片悬停效果 */
.card {
  position: relative;
  overflow: hidden;
  transition: var(--transition-normal);
}

.card::after {
  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.5s;
}

.card:hover::after {
  left: 100%;
}

/* 加载动画 */
.loading {
  position: relative;
}

.loading::before {
  content: '';
  position: absolute;
  top: 0;
  left: 0;
  width: 100%;
  height: 100%;
  background: linear-gradient(
    90deg,
    transparent,
    rgba(255, 255, 255, 0.4),
    transparent
  );
  animation: shimmer 1.5s infinite;
}

@keyframes shimmer {
  0% {
    transform: translateX(-100%);
  }
  100% {
    transform: translateX(100%);
  }
}

滚动驱动动画

/* 滚动驱动动画 */
.scroll-animation {
  opacity: 0;
  transform: translateY(30px);
  transition: opacity 0.6s ease, transform 0.6s ease;
}

.scroll-animation.in-view {
  opacity: 1;
  transform: translateY(0);
}

/* 视差滚动效果 */
.parallax {
  transform: translateZ(0);
  will-change: transform;
}

.parallax--slow {
  transform: translateY(var(--scroll-offset, 0) * 0.5);
}

.parallax--fast {
  transform: translateY(var(--scroll-offset, 0) * -0.5);
}

/* 滚动进度指示器 */
.scroll-progress {
  position: fixed;
  top: 0;
  left: 0;
  width: 100%;
  height: 4px;
  background: var(--color-primary-500);
  transform-origin: left;
  transform: scaleX(var(--scroll-progress, 0));
  z-index: var(--z-fixed);
}

🏗 CSS 工程实践

现代 CSS 架构

/* 1. 设计令牌层 */
@import 'tokens/colors.css';
@import 'tokens/spacing.css';
@import 'tokens/typography.css';
@import 'tokens/shadows.css';

/* 2. 基础样式层 */
@import 'base/reset.css';
@import 'base/typography.css';
@import 'base/utilities.css';

/* 3. 组件层 */
@import 'components/button.css';
@import 'components/card.css';
@import 'components/form.css';

/* 4. 布局层 */
@import 'layout/container.css';
@import 'layout/grid.css';
@import 'layout/header.css';

/* 5. 页面层 */
@import 'pages/home.css';
@import 'pages/about.css';

组件样式组织

/* 组件样式结构 */
.component {
  /* 1. 布局属性 */
  display: flex;
  flex-direction: column;
  gap: var(--space-4);
  
  /* 2. 尺寸属性 */
  width: 100%;
  min-height: 200px;
  
  /* 3. 外观属性 */
  background-color: var(--color-bg-secondary);
  border: 1px solid var(--color-border-primary);
  border-radius: var(--radius-lg);
  
  /* 4. 文本属性 */
  font-family: var(--font-family-sans);
  font-size: var(--font-size-base);
  color: var(--color-text-primary);
  
  /* 5. 交互属性 */
  cursor: pointer;
  transition: var(--transition-normal);
  
  /* 6. 其他属性 */
  overflow: hidden;
  position: relative;
}

/* 组件变体 */
.component--variant {
  /* 覆盖特定属性 */
  background-color: var(--color-primary-500);
  color: white;
}

/* 组件状态 */
.component:hover {
  transform: translateY(-2px);
  box-shadow: var(--shadow-lg);
}

.component:focus {
  outline: 2px solid var(--color-primary-500);
  outline-offset: 2px;
}

.component:disabled {
  opacity: 0.6;
  cursor: not-allowed;
}

/* 组件子元素 */
.component__header {
  padding: var(--space-4);
  border-bottom: 1px solid var(--color-border-primary);
}

.component__content {
  padding: var(--space-4);
  flex: 1;
}

.component__footer {
  padding: var(--space-4);
  border-top: 1px solid var(--color-border-primary);
  background-color: var(--color-bg-tertiary);
}

工具类系统

/* 间距工具类 */
.m-0 { margin: var(--space-0); }
.m-1 { margin: var(--space-1); }
.m-2 { margin: var(--space-2); }
.m-3 { margin: var(--space-3); }
.m-4 { margin: var(--space-4); }

.mt-0 { margin-top: var(--space-0); }
.mt-1 { margin-top: var(--space-1); }
.mt-2 { margin-top: var(--space-2); }
.mt-3 { margin-top: var(--space-3); }
.mt-4 { margin-top: var(--space-4); }

.p-0 { padding: var(--space-0); }
.p-1 { padding: var(--space-1); }
.p-2 { padding: var(--space-2); }
.p-3 { padding: var(--space-3); }
.p-4 { padding: var(--space-4); }

/* 显示工具类 */
.block { display: block; }
.inline { display: inline; }
.inline-block { display: inline-block; }
.flex { display: flex; }
.grid { display: grid; }
.hidden { display: none; }

/* 文本工具类 */
.text-left { text-align: left; }
.text-center { text-align: center; }
.text-right { text-align: right; }
.text-justify { text-align: justify; }

.text-xs { font-size: var(--font-size-xs); }
.text-sm { font-size: var(--font-size-sm); }
.text-base { font-size: var(--font-size-base); }
.text-lg { font-size: var(--font-size-lg); }
.text-xl { font-size: var(--font-size-xl); }

.font-light { font-weight: var(--font-weight-light); }
.font-normal { font-weight: var(--font-weight-normal); }
.font-medium { font-weight: var(--font-weight-medium); }
.font-semibold { font-weight: var(--font-weight-semibold); }
.font-bold { font-weight: var(--font-weight-bold); }

/* 颜色工具类 */
.text-primary { color: var(--color-text-primary); }
.text-secondary { color: var(--color-text-secondary); }
.text-success { color: var(--color-success); }
.text-warning { color: var(--color-warning); }
.text-error { color: var(--color-error); }

.bg-primary { background-color: var(--color-bg-primary); }
.bg-secondary { background-color: var(--color-bg-secondary); }
.bg-success { background-color: var(--color-success); }
.bg-warning { background-color: var(--color-warning); }
.bg-error { background-color: var(--color-error); }

🧪 实战练习

练习1：实现响应式卡片组件

<!-- ResponsiveCard.vue -->
<template>
  <article class="card" :class="cardClass">
    <div class="card__image">
      <img :src="image" :alt="title" />
    </div>
    <div class="card__content">
      <h3 class="card__title">{{ title }}</h3>
      <p class="card__description">{{ description }}</p>
      <div class="card__actions">
        <button class="btn btn--primary">Read More</button>
      </div>
    </div>
  </article>
</template>

<script setup lang="ts">
interface Props {
  title: string
  description: string
  image: string
  variant?: 'default' | 'featured'
}

const props = withDefaults(defineProps<Props>(), {
  variant: 'default'
})

const cardClass = computed(() => ({
  'card--featured': props.variant === 'featured'
}))
</script>

<style scoped>
.card {
  container-type: inline-size;
  display: flex;
  flex-direction: column;
  background: var(--color-bg-secondary);
  border: 1px solid var(--color-border-primary);
  border-radius: var(--radius-lg);
  overflow: hidden;
  transition: var(--transition-normal);
}

.card:hover {
  transform: translateY(-4px);
  box-shadow: var(--shadow-lg);
}

.card__image {
  position: relative;
  aspect-ratio: 16 / 9;
  overflow: hidden;
}

.card__image img {
  width: 100%;
  height: 100%;
  object-fit: cover;
  transition: var(--transition-normal);
}

.card:has(.card__image:hover) img {
  transform: scale(1.05);
}

.card__content {
  padding: var(--space-4);
  display: flex;
  flex-direction: column;
  gap: var(--space-3);
  flex: 1;
}

.card__title {
  font-size: var(--font-size-lg);
  font-weight: var(--font-weight-semibold);
  color: var(--color-text-primary);
  margin: 0;
}

.card__description {
  color: var(--color-text-secondary);
  line-height: var(--line-height-relaxed);
  margin: 0;
  flex: 1;
}

.card__actions {
  margin-top: auto;
}

/* 容器查询 */
@container (min-width: 300px) {
  .card {
    flex-direction: row;
  }
  
  .card__image {
    flex: 0 0 200px;
    aspect-ratio: 1;
  }
}

@container (min-width: 500px) {
  .card__content {
    padding: var(--space-6);
  }
  
  .card__title {
    font-size: var(--font-size-xl);
  }
}

/* 特色卡片 */
.card--featured {
  border: 2px solid var(--color-primary-500);
}

.card--featured .card__title {
  color: var(--color-primary-500);
}
</style>

练习2：实现主题切换系统

<!-- ThemeToggle.vue -->
<template>
  <button 
    class="theme-toggle"
    @click="toggleTheme"
    :aria-label="`切换到${nextTheme}主题`"
  >
    <span class="theme-toggle__icon">
      <component :is="currentIcon" />
    </span>
    <span class="theme-toggle__text">{{ currentTheme }}</span>
  </button>
</template>

<script setup lang="ts">
import { ref, computed, onMounted } from 'vue'

type Theme = 'light' | 'dark' | 'high-contrast'

const currentTheme = ref<Theme>('light')

const themes: Theme[] = ['light', 'dark', 'high-contrast']

const currentIndex = computed(() => 
  themes.indexOf(currentTheme.value)
)

const nextTheme = computed(() => 
  themes[(currentIndex.value + 1) % themes.length]
)

const currentIcon = computed(() => {
  switch (currentTheme.value) {
    case 'light':
      return 'SunIcon'
    case 'dark':
      return 'MoonIcon'
    case 'high-contrast':
      return 'ContrastIcon'
    default:
      return 'SunIcon'
  }
})

const toggleTheme = () => {
  currentTheme.value = nextTheme.value
  applyTheme(currentTheme.value)
}

const applyTheme = (theme: Theme) => {
  document.documentElement.setAttribute('data-theme', theme)
  localStorage.setItem('theme', theme)
}

onMounted(() => {
  const savedTheme = localStorage.getItem('theme') as Theme
  if (savedTheme && themes.includes(savedTheme)) {
    currentTheme.value = savedTheme
  }
  applyTheme(currentTheme.value)
})
</script>

<style scoped>
.theme-toggle {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  padding: var(--space-2) var(--space-3);
  background: var(--color-bg-secondary);
  border: 1px solid var(--color-border-primary);
  border-radius: var(--radius-md);
  color: var(--color-text-primary);
  cursor: pointer;
  transition: var(--transition-fast);
}

.theme-toggle:hover {
  background: var(--color-bg-tertiary);
  border-color: var(--color-primary-500);
}

.theme-toggle__icon {
  width: 16px;
  height: 16px;
}

.theme-toggle__text {
  font-size: var(--font-size-sm);
  font-weight: var(--font-weight-medium);
}
</style>

练习3：实现高性能动画组件

<!-- AnimatedCard.vue -->
<template>
  <div 
    class="animated-card"
    :class="cardClass"
    @mouseenter="handleMouseEnter"
    @mouseleave="handleMouseLeave"
    @click="handleClick"
  >
    <div class="animated-card__content">
      <slot />
    </div>
    <div class="animated-card__ripple" ref="rippleRef"></div>
  </div>
</template>

<script setup lang="ts">
import { ref, computed } from 'vue'

interface Props {
  variant?: 'default' | 'elevated' | 'outlined'
  disabled?: boolean
}

const props = withDefaults(defineProps<Props>(), {
  variant: 'default',
  disabled: false
})

const emit = defineEmits<{
  click: [event: MouseEvent]
}>()

const rippleRef = ref<HTMLElement>()
const isHovered = ref(false)
const isPressed = ref(false)

const cardClass = computed(() => ({
  'animated-card--elevated': props.variant === 'elevated',
  'animated-card--outlined': props.variant === 'outlined',
  'animated-card--disabled': props.disabled,
  'animated-card--hovered': isHovered.value,
  'animated-card--pressed': isPressed.value
}))

const handleMouseEnter = () => {
  if (!props.disabled) {
    isHovered.value = true
  }
}

const handleMouseLeave = () => {
  isHovered.value = false
  isPressed.value = false
}

const handleClick = (event: MouseEvent) => {
  if (props.disabled) return
  
  isPressed.value = true
  createRipple(event)
  
  setTimeout(() => {
    isPressed.value = false
  }, 150)
  
  emit('click', event)
}

const createRipple = (event: MouseEvent) => {
  const rect = (event.currentTarget as HTMLElement).getBoundingClientRect()
  const size = Math.max(rect.width, rect.height)
  const x = event.clientX - rect.left - size / 2
  const y = event.clientY - rect.top - size / 2
  
  if (rippleRef.value) {
    rippleRef.value.style.width = `${size}px`
    rippleRef.value.style.height = `${size}px`
    rippleRef.value.style.left = `${x}px`
    rippleRef.value.style.top = `${y}px`
    rippleRef.value.classList.add('animated-card__ripple--active')
    
    setTimeout(() => {
      rippleRef.value?.classList.remove('animated-card__ripple--active')
    }, 600)
  }
}
</script>

<style scoped>
.animated-card {
  position: relative;
  overflow: hidden;
  background: var(--color-bg-secondary);
  border-radius: var(--radius-lg);
  cursor: pointer;
  transition: var(--transition-fast);
  will-change: transform, box-shadow;
}

.animated-card--elevated {
  box-shadow: var(--shadow-md);
}

.animated-card--outlined {
  border: 1px solid var(--color-border-primary);
}

.animated-card--disabled {
  opacity: 0.6;
  cursor: not-allowed;
}

.animated-card--hovered {
  transform: translateY(-2px);
  box-shadow: var(--shadow-lg);
}

.animated-card--pressed {
  transform: translateY(0) scale(0.98);
}

.animated-card__content {
  position: relative;
  z-index: 1;
  padding: var(--space-4);
}

.animated-card__ripple {
  position: absolute;
  border-radius: 50%;
  background: rgba(255, 255, 255, 0.3);
  transform: scale(0);
  opacity: 0;
  pointer-events: none;
  transition: transform 0.6s ease, opacity 0.6s ease;
}

.animated-card__ripple--active {
  transform: scale(1);
  opacity: 1;
}

/* 减少动画（用户偏好） */
@media (prefers-reduced-motion: reduce) {
  .animated-card {
    transition: none;
  }
  
  .animated-card__ripple {
    transition: none;
  }
}
</style>

📚 最佳实践

1. 性能优化

/* ✅ 使用 transform 和 opacity 进行动画 */
.good-animation {
  transition: transform 0.3s ease, opacity 0.3s ease;
}

/* ✅ 合理使用 will-change */
.optimized {
  will-change: transform;
}

.optimized.animation-complete {
  will-change: auto;
}

/* ✅ 使用 contain 属性优化渲染 */
.isolated-component {
  contain: layout style paint;
}

2. 可访问性

/* ✅ 支持减少动画偏好 */
@media (prefers-reduced-motion: reduce) {
  * {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
  }
}

/* ✅ 支持高对比度模式 */
@media (prefers-contrast: high) {
  .button {
    border: 2px solid currentColor;
  }
}

/* ✅ 支持深色模式 */
@media (prefers-color-scheme: dark) {
  :root {
    --color-bg-primary: var(--color-gray-900);
    --color-text-primary: var(--color-gray-100);
  }
}

3. 维护性

/* ✅ 使用 CSS 变量统一管理 */
:root {
  --component-padding: var(--space-4);
  --component-radius: var(--radius-md);
  --component-shadow: var(--shadow-md);
}

.component {
  padding: var(--component-padding);
  border-radius: var(--component-radius);
  box-shadow: var(--component-shadow);
}

/* ✅ 使用逻辑属性 */
.component {
  margin-inline: var(--space-4);
  margin-block: var(--space-2);
  padding-inline: var(--space-3);
  padding-block: var(--space-2);
}

🚨 常见问题

1. 容器查询不生效

问题：容器查询样式没有应用解决：确保父元素设置了 container-type 属性

/* ❌ 错误 */
.card {
  /* 没有设置 container-type */
}

@container (min-width: 300px) {
  .card__content { /* 不会生效 */ }
}

/* ✅ 正确 */
.card {
  container-type: inline-size;
}

@container (min-width: 300px) {
  .card__content { /* 会生效 */ }
}

2. :has() 选择器兼容性

问题：:has() 选择器在某些浏览器中不支持解决：使用 JavaScript 作为降级方案

/* CSS 方案 */
.field:has(input:focus) {
  border-color: var(--color-primary-500);
}

/* JavaScript 降级方案 */
.field.focused {
  border-color: var(--color-primary-500);
}

3. 动画性能问题

问题：动画卡顿解决：只使用 transform 和 opacity，避免触发布局

/* ❌ 会触发布局 */
.bad-animation {
  transition: width 0.3s ease, height 0.3s ease;
}

/* ✅ 只触发合成 */
.good-animation {
  transition: transform 0.3s ease, opacity 0.3s ease;
}

📖 延伸阅读

下一章预告：我们将学习测试与质量保证，包括单元测试、端到端测试、可视化回归测试等，为构建高质量的应用打下基础。