Communitygithub.com

Funnyhust/POC_Kaenx_Creator

建立整合幻燈片/投影片的登陸頁面,適合知識分享簡報。僅在用戶同時明確要求登陸頁面和幻燈片功能時使用。不用於一般登陸頁面或獨立幻燈片。

POC_Kaenx_Creator 是什麼?

此技能「Landing Page Slider」專為需要同時具備登陸頁面與全螢幕幻燈片/投影片功能的專案而設計,特別適合知識分享與行銷簡報場景。它基於 Vite 5+、React 18+、Tailwind CSS v4、Lucide React 和 Framer Motion 等現代技術棧,能快速建立具有專業動畫與毛玻璃效果的頁面。核心功能包括一個可切換登陸與簡報模式的滑動容器、自訂鍵盤導航(方向鍵、空白鍵、Esc 等)、以及基於 oklch 色彩空間的漸層主題。開發者只需遵循快速啟動步驟(建立專案、安裝依賴、配置 Vite 與 Tailwind v4 主題)即可開始。此技能也提供豐富的範例元件(Slider、Slide、鍵盤 Hook)與最佳實踐建議,如色彩和諧、效能最佳化(延遲載入、will-change)及無障礙支援(鍵盤導航、ARIA 標籤)。適用平台包含 Claude Code、Cursor、Codex 等支援 AI 代理的技能執行環境,主要透過 README.md 或 SKILL.md 中的決策樹引導開發流程。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Funnyhust/POC_Kaenx_Creator/tree/HEAD/.agent/skills/landing-page-slider

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

登陸頁面幻燈片 (Landing Page Slider)

建構能轉換為全螢幕簡報的美麗登陸頁面,具備鍵盤導航、毛玻璃效果與專業動畫。

何時使用此技能

[!IMPORTANT] 此技能適用於需要同時結合登陸頁面與幻燈片/投影片功能的專案。

  • 使用者明確要求「附帶幻燈片的登陸頁面」或「簡報型登陸頁面」
  • 建立具備投影片模式的知識分享頁面
  • 打造可切換至簡報模式的行銷網站
  • 不適用於:一般登陸頁面、獨立輪播/滑塊、單純幻燈片

技術棧

技術版本用途
Vite5+建構工具
React18+UI 框架
Tailwind CSSv4樣式(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>

最佳實踐

視覺卓越

  1. 色彩和諧 - 使用 oklch 色彩以獲得一致且鮮明的漸層
  2. 深度層次 - 結合模糊 + 透明度 + 微妙邊框
  3. 動畫目的 - 動畫用於引導注意力,而非分散
  4. 深色模式優先 - 毛玻璃效果在深色背景上更為突出

效能

  1. 延遲載入 - 按需載入幻燈片內容
  2. will-change - 為動畫元素加入
  3. 減少動畫 - 尊重 prefers-reduced-motion

無障礙

  1. 焦點可見 - 在簡報模式中有清晰的焦點指示器
  2. 鍵盤導航 - 完整的鍵盤支援(已內建)
  3. ARIA 標籤 - 為導航控制項加上標籤

決策樹

你需要什麼?
├── 新的登陸頁面專案
│   └── 遵循快速啟動(步驟 1-4)
├── 為現有 React 應用加入幻燈片
│   └── 複製 Slider 元件 + hook
├── 自訂視覺樣式
│   └── 修改 CSS 中的 @theme 區塊
└── 更改鍵盤快捷鍵
    └── 編輯 useKeyboard hook

範例與資源

範例

常見錯誤

錯誤解決方案
模糊效果無作用確保父元素有 position: relative 或 overflow: hidden
動畫卡頓為動畫元素加入 will-change: transform
顏色看起來褪色使用 oklch 以獲得廣色域支援
鍵盤沒反應檢查焦點是否在容器元素上

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能