랜딩 페이지 슬라이더은(는) 무엇을 하나요?
키보드 내비게이션, 글래스모피즘 효과, 전문적인 애니메이션을 갖춘 아름다운 랜딩 페이지를 전체 화면 프레젠테이션으로 변환하세요.
이 스킬 사용 시기
[!IMPORTANT] 이 스킬은 랜딩 페이지 와 슬라이더/슬라이드쇼 기능이 모두 필요한 프로젝트를 위한 것입니다.
- 사용자가 "랜딩 페이지 with 슬라이더" 또는 "프레젠테이션 랜딩 페이지"를 명시적으로 요청할 때
- 슬라이드쇼 모드가 있는 지식 공유 페이지를 구축할 때
- 프레젠테이션 모드로 전환할 수 있는 마케팅 사이트를 만들 때
- 사용하지 말아야 할 경우: 일반 랜딩 페이지, 독립형 캐러셀/슬라이더, 단순 슬라이드쇼
기술 스택
| 기술 | 버전 | 용도 |
|---|---|---|
| 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 {
/* P3 디스플레이를 위한 oklch 기본 그라데이션 색상 */
--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 사용 |
| 키보드가 작동하지 않음 | 포커스가 컨테이너 요소에 있는지 확인 |