登陸頁面幻燈片 (Landing Page Slider)
建構能轉換為全螢幕簡報的美麗登陸頁面,具備鍵盤導航、毛玻璃效果與專業動畫。
何時使用此技能
[!IMPORTANT] 此技能適用於需要同時結合登陸頁面與幻燈片/投影片功能的專案。
- 使用者明確要求「附帶幻燈片的登陸頁面」或「簡報型登陸頁面」
- 建立具備投影片模式的知識分享頁面
- 打造可切換至簡報模式的行銷網站
- 不適用於:一般登陸頁面、獨立輪播/滑塊、單純幻燈片
技術棧
| 技術 | 版本 | 用途 |
|---|---|---|
| Vite | 5+ | 建構工具 |
| React | 18+ | UI 框架 |
| Tailwind CSS | v4 | 樣式(CSS-first) |
| 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. 幻燈片容器 (Slider Container)
管理簡報模式與幻燈片導航的主要元件。
主要功能:
- 在登陸頁面與簡報模式之間切換
- 追蹤當前幻燈片索引
- 處理幻燈片之間的動畫
- 全螢幕支援
2. 幻燈片元件 (Slide Component)
變成全螢幕幻燈片的個別內容區段。
主要功能:
- 內容區域(標題、描述、視覺元素)
- 進場/出場動畫
- 毛玻璃卡片樣式
3. 鍵盤導航 Hook (Keyboard Navigation Hook)
自訂鍵盤快捷鍵的 Hook。
| 按鍵 | 動作 |
|---|---|
← / → | 導航幻燈片 |
Space | 下一張幻燈片 |
Escape | 離開簡報模式 |
F | 切換全螢幕 |
P | 切換簡報模式 |
毛玻璃模式 (Glassmorphism Patterns)
模糊卡片
<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>
動畫模式 (Animation Patterns)
子元素錯開動畫 (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 應用加入幻燈片
│ └── 複製 Slider 元件 + hook
├── 自訂視覺樣式
│ └── 修改 CSS 中的 @theme 區塊
└── 更改鍵盤快捷鍵
└── 編輯 useKeyboard hook
範例與資源
範例
- 專案結構 - 完整資料夾佈局
- Slider 元件 - 主要幻燈片邏輯
- Slide 元件 - 個別幻燈片與內容元件
- 鍵盤 Hook - 鍵盤導航
- 主題 CSS - Tailwind v4 主題設定
- 登陸頁面 - 完整頁面範例
常見錯誤
| 錯誤 | 解決方案 |
|---|---|
| 模糊效果無作用 | 確保父元素有 position: relative 或 overflow: hidden |
| 動畫卡頓 | 為動畫元素加入 will-change: transform |
| 顏色看起來褪色 | 使用 oklch 以獲得廣色域支援 |
| 鍵盤沒反應 | 檢查焦點是否在容器元素上 |