登录页面滑块
构建美丽的登录页面,可转换为全屏演示,支持键盘导航、毛玻璃效果和专业动画。
何时使用此技能
[!重要] 此技能适用于需要同时具备登录页面和滑块/幻灯片功能相结合的项目。
- 用户明确要求“带滑块的登录页面”或“演示登录页面”
- 构建带有幻灯片模式的知识分享页面
- 创建可切换为演示模式的市场营销网站
- 不适用于:常规登录页面、独立轮播/滑块、简单幻灯片
技术栈
| 技术 | 版本 | 用途 |
|---|---|---|
| Vite | 5+ | 构建工具 |
| React | 18+ | UI 框架 |
| Tailwind CSS | v4 | 样式(CSS 优先) |
| Lucide React | 最新 | 专业图标 |
| Framer Motion | 最新 | 动画 |
快速开始
步骤 1:创建项目
npm create vite@latest my-landing -- --template react-ts
cd my-landing
npm install
步骤 2:安装依赖
npm install tailwindcss @tailwindcss/vite lucide-react framer-motion
步骤 3:配置 Vite
// vite.config.ts
import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'
import tailwindcss from '@tailwindcss/vite'
export default defineConfig({
plugins: [react(), tailwindcss()],
})
步骤 4:设置 Tailwind CSS v4
/* src/index.css */
@import "tailwindcss";
@theme {
/* 使用 oklch 的主渐变颜色,支持 P3 显示 */
--color-primary: oklch(0.65 0.18 250);
--color-secondary: oklch(0.55 0.15 280);
--color-accent: oklch(0.75 0.2 160);
/* 毛玻璃颜色 */
--color-glass-bg: oklch(0.15 0.02 260 / 0.6);
--color-glass-border: oklch(1 0 0 / 0.1);
/* 动画 */
--animate-slide-in: slide-in 0.5s ease-out;
--animate-fade-up: fade-up 0.6s ease-out;
--animate-glow: glow 2s ease-in-out infinite;
}
@keyframes slide-in {
from { transform: translateX(100%); opacity: 0; }
to { transform: translateX(0); opacity: 1; }
}
@keyframes fade-up {
from { transform: translateY(20px); opacity: 0; }
to { transform: translateY(0); opacity: 1; }
}
@keyframes glow {
0%, 100% { box-shadow: 0 0 20px oklch(0.65 0.18 250 / 0.3); }
50% { box-shadow: 0 0 40px oklch(0.65 0.18 250 / 0.6); }
}
核心组件
1. 滑块容器
管理演示模式和幻灯片导航的主组件。
主要特性:
- 在登录页面和演示模式之间切换
- 跟踪当前幻灯片索引
- 处理幻灯片间的动画
- 全屏支持
2. 幻灯片组件
成为全屏幻灯片的各个内容部分。
主要特性:
- 内容区域(标题、描述、视觉元素)
- 进入/退出动画
- 毛玻璃卡片样式
3. 键盘导航钩子
用于键盘快捷键的自定义钩子。
| 按键 | 操作 |
|---|---|
← / → | 导航幻灯片 |
Space | 下一张幻灯片 |
Escape | 退出演示 |
F | 切换全屏 |
P | 切换演示模式 |
毛玻璃样式
带模糊的卡片
<div className="
bg-glass-bg
backdrop-blur-xl
border border-glass-border
rounded-2xl
shadow-2xl
">
{/* 内容 */}
</div>
渐变光晕(背景)
<div className="absolute inset-0 overflow-hidden -z-10">
<div className="
absolute -top-40 -right-40 w-80 h-80
bg-primary/30 rounded-full blur-3xl
" />
<div className="
absolute -bottom-40 -left-40 w-80 h-80
bg-secondary/30 rounded-full blur-3xl
" />
</div>
动画模式
交错子元素(Framer Motion)
const container = {
hidden: { opacity: 0 },
show: {
opacity: 1,
transition: { staggerChildren: 0.1 }
}
}
const item = {
hidden: { y: 20, opacity: 0 },
show: { y: 0, opacity: 1 }
}
<motion.div variants={container} initial="hidden" animate="show">
{items.map(i => <motion.div key={i} variants={item} />)}
</motion.div>
幻灯片过渡
<AnimatePresence mode="wait">
<motion.div
key={currentSlide}
initial={{ x: 100, opacity: 0 }}
animate={{ x: 0, opacity: 1 }}
exit={{ x: -100, opacity: 0 }}
transition={{ duration: 0.3, ease: "easeOut" }}
>
{slides[currentSlide]}
</motion.div>
</AnimatePresence>
最佳实践
视觉卓越性
- 色彩和谐 - 使用 oklch 颜色实现一致、鲜艳的渐变
- 深度层次 - 结合模糊 + 透明度 + 微妙边框
- 动感目的 - 动画用于引导注意力,而非分散注意力
- 深色模式优先 - 毛玻璃效果在深色背景上表现出色
性能
- 懒加载 - 按需加载幻灯片内容
- will-change - 为动画元素添加
- 减少动画 - 尊重
prefers-reduced-motion
可访问性
- 焦点可见 - 在演示模式下有清晰的焦点指示器
- 键盘导航 - 完整的键盘支持(已内置)
- ARIA 标签 - 为导航控件添加标签
决策树
你需要什么?
├── 新的登录页面项目
│ └── 遵循快速开始(步骤 1-4)
├── 为现有 React 应用添加滑块
│ └── 复制滑块组件 + 钩子
├── 自定义视觉样式
│ └── 修改 CSS 中的 @theme 块
└── 更改键盘快捷键
└── 编辑 useKeyboard 钩子
示例与资源
示例
- 项目结构 - 完整的文件夹布局
- 滑块组件 - 滑块主要逻辑
- 幻灯片组件 - 单个幻灯片 + 内容组件
- 键盘钩子 - 键盘导航
- 主题 CSS - Tailwind v4 主题设置
- 登录页面 - 完整页面示例
常见错误
| 错误 | 解决方案 |
|---|---|
| 模糊效果不生效 | 确保父元素具有 position: relative 或 overflow: hidden |
| 动画卡顿 | 对动画元素添加 will-change: transform |
| 颜色看起来暗淡 | 使用 oklch 以获得更宽的色域支持 |
| 键盘不起作用 | 检查焦点是否在容器元素上 |