Carrusel de Página de Aterrizaje
Crea páginas de aterrizaje hermosas que se transforman en presentaciones a pantalla completa con navegación por teclado, efectos de vidrio esmerilado (glassmorphism) y animaciones profesionales.
Cuándo usar esta habilidad
[!IMPORTANTE] Esta habilidad es para proyectos que necesitan TANTO una página de aterrizaje COMO funcionalidad de carrusel/presentación combinadas.
- El usuario solicita explícitamente "página de aterrizaje con carrusel" o "página de aterrizaje tipo presentación"
- Construcción de páginas para compartir conocimientos con modo de presentación
- Creación de sitios de marketing que puedan alternar al modo de presentación
- NO para: Páginas de aterrizaje regulares, carruseles independientes, presentaciones simples
Stack Tecnológico
| Tecnología | Versión | Propósito |
|---|---|---|
| Vite | 5+ | Herramienta de construcción |
| React | 18+ | Framework de UI |
| Tailwind CSS | v4 | Estilos (CSS-first) |
| Lucide React | Última | Iconos profesionales |
| Framer Motion | Última | Animaciones |
Inicio Rápido
Paso 1: Crear Proyecto
npm create vite@latest my-landing -- --template react-ts
cd my-landing
npm install
Paso 2: Instalar Dependencias
npm install tailwindcss @tailwindcss/vite lucide-react framer-motion
Paso 3: Configurar 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()],
})
Paso 4: Configurar Tailwind CSS v4
/* src/index.css */
@import "tailwindcss";
@theme {
/* Colores primarios de gradiente usando oklch para pantalla 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);
/* Colores para vidrio esmerilado */
--color-glass-bg: oklch(0.15 0.02 260 / 0.6);
--color-glass-border: oklch(1 0 0 / 0.1);
/* Animaciones */
--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); }
}
Componentes Principales
1. Contenedor de Diapositivas
El componente principal que gestiona el modo de presentación y la navegación entre diapositivas.
Características clave:
- Alternar entre página de aterrizaje y modo de presentación
- Seguimiento del índice de diapositiva actual
- Manejo de animaciones entre diapositivas
- Soporte para pantalla completa
2. Componente de Diapositiva
Secciones de contenido individuales que se convierten en diapositivas a pantalla completa.
Características clave:
- Áreas de contenido (título, descripción, imágenes)
- Animaciones de entrada/salida
- Estilo de tarjeta con vidrio esmerilado
3. Hook de Navegación por Teclado
Hook personalizado para atajos de teclado.
| Tecla | Acción |
|---|---|
← / → | Navegar diapositivas |
Espacio | Siguiente diapositiva |
Escape | Salir de la presentación |
F | Alternar pantalla completa |
P | Alternar modo de presentación |
Patrones de Vidrio Esmerilado
Tarjeta con Desenfoque
<div className="
bg-glass-bg
backdrop-blur-xl
border border-glass-border
rounded-2xl
shadow-2xl
">
{/* contenido */}
</div>
Orbes de Gradiente (Fondo)
<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>
Patrones de Animación
Hijos Escalonados (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>
Transiciones de Diapositiva
<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>
Mejores Prácticas
Excelencia Visual
- Armonía de color: Usa colores oklch para gradientes consistentes y vibrantes
- Capas de profundidad: Combina desenfoque + transparencia + bordes sutiles
- Movimiento con propósito: Anima para guiar la atención, no para distraer
- Modo oscuro primero: El vidrio esmerilado brilla sobre fondos oscuros
Rendimiento
- Carga diferida: Carga el contenido de las diapositivas bajo demanda
- will-change: Añádelo a los elementos animados
- Reducir movimiento: Respeta
prefers-reduced-motion
Accesibilidad
- Enfoque visible: Indicadores de enfoque claros en modo presentación
- Navegación por teclado: Soporte completo de teclado (ya incorporado)
- Etiquetas ARIA: Etiqueta los controles de navegación
Árbol de Decisión
¿Qué necesitas?
├── Nuevo proyecto de página de aterrizaje
│ └── Sigue el Inicio Rápido (Pasos 1-4)
├── Añadir carrusel a una app React existente
│ └── Copia el componente Slider + hook
├── Personalizar estilo visual
│ └── Modifica el bloque @theme en CSS
└── Cambiar atajos de teclado
└── Edita el hook useKeyboard
Ejemplos y Recursos
Ejemplos
- Estructura del Proyecto - Disposición completa de carpetas
- Componente Slider - Lógica principal del carrusel
- Componente Diapositiva - Diapositiva individual + componentes de contenido
- Hook de Teclado - Navegación por teclado
- CSS de Tema - Configuración del tema de Tailwind v4
- Página de Aterrizaje - Ejemplo de página completa
Errores Comunes
| Error | Solución |
|---|---|
| El desenfoque no funciona | Asegúrate de que el contenedor padre tenga position: relative o overflow: hidden |
| Animaciones entrecortadas | Añade will-change: transform a los elementos animados |
| Colores se ven deslavados | Usa oklch para un soporte de gama más amplia |
| El teclado no funciona | Verifica que el foco esté en el elemento contenedor |