Communitygithub.com

Funnyhust/POC_Kaenx_Creator

创建集登录页面与滑块/幻灯片功能于一体的演示页面,用于知识分享展示。仅当用户明确同时请求登录页面和滑块/幻灯片功能时使用。不适用于常规登录页面或独立滑块。

POC_Kaenx_Creator 是什么?

该技能专门用于创建兼具登录页面和全屏幻灯片演示功能的现代化网站。它基于 Vite + React + Tailwind CSS v4 + Framer Motion 技术栈,提供毛玻璃视觉效果和流畅动画。技能包含完整的项目初始化步骤、自定义钩子(如键盘导航)、动画模式(交错子元素、幻灯片过渡)以及最佳实践指南(视觉优化、性能、可访问性)。特别适合需要将内容展示从浏览模式一键切换为演示模式的场景,如知识分享、市场宣传等。平台支持:Vite 5+,React 18+。使用时需注意,它仅适用于明确要求“登录页面+滑块”组合的项目,不适用于普通登录页面或独立轮播。

兼容平台~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 的新对话。

文档

登录页面滑块

构建美丽的登录页面,可转换为全屏演示,支持键盘导航、毛玻璃效果和专业动画。

何时使用此技能

[!重要] 此技能适用于需要同时具备登录页面和滑块/幻灯片功能相结合的项目。

  • 用户明确要求“带滑块的登录页面”或“演示登录页面”
  • 构建带有幻灯片模式的知识分享页面
  • 创建可切换为演示模式的市场营销网站
  • 不适用于:常规登录页面、独立轮播/滑块、简单幻灯片

技术栈

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

最佳实践

视觉卓越性

  1. 色彩和谐 - 使用 oklch 颜色实现一致、鲜艳的渐变
  2. 深度层次 - 结合模糊 + 透明度 + 微妙边框
  3. 动感目的 - 动画用于引导注意力,而非分散注意力
  4. 深色模式优先 - 毛玻璃效果在深色背景上表现出色

性能

  1. 懒加载 - 按需加载幻灯片内容
  2. will-change - 为动画元素添加
  3. 减少动画 - 尊重 prefers-reduced-motion

可访问性

  1. 焦点可见 - 在演示模式下有清晰的焦点指示器
  2. 键盘导航 - 完整的键盘支持(已内置)
  3. ARIA 标签 - 为导航控件添加标签

决策树

你需要什么?
├── 新的登录页面项目
│   └── 遵循快速开始(步骤 1-4)
├── 为现有 React 应用添加滑块
│   └── 复制滑块组件 + 钩子
├── 自定义视觉样式
│   └── 修改 CSS 中的 @theme 块
└── 更改键盘快捷键
    └── 编辑 useKeyboard 钩子

示例与资源

示例

常见错误

错误解决方案
模糊效果不生效确保父元素具有 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.

相关技能