Mejores Prácticas de Animación de Emil Kowalski
Guía completa de animación para interfaces web basada en las enseñanzas de Emil Kowalski, bibliotecas de código abierto (Sonner, Vaul) y su curso animations.dev. Contiene 43 reglas en 7 categorías, priorizadas por impacto.
Cuándo Aplicar
Consulta estas pautas cuando:
- Añadas animaciones a componentes React
- Elijas curvas de easing o valores de sincronización
- Implementes interacciones basadas en gestos (deslizar, arrastrar)
- Construyas componentes de notificaciones toast o cajones deslizantes
- Optimices el rendimiento de las animaciones
- Garantices la accesibilidad de las animaciones
Categorías de Reglas por Prioridad
| Prioridad | Categoría | Impacto | Prefijo |
|---|---|---|---|
| 1 | Selección de Easing | CRÍTICO | ease- |
| 2 | Sincronización y Duración | CRÍTICO | timing- |
| 3 | Selección de Propiedades | ALTO | props- |
| 4 | Técnicas de Transformación | ALTO | transform- |
| 5 | Patrones de Interacción | MEDIO-ALTO | interact- |
| 6 | Animación Estratégica | MEDIO | strategy- |
| 7 | Accesibilidad y Acabados | MEDIO | polish- |
Referencia Rápida
1. Selección de Easing (CRÍTICO)
ease-out-default- Usa ease-out como easing predeterminadoease-custom-curves- Usa cubic-bezier personalizado en lugar del CSS incorporadoease-in-out-onscreen- Usa ease-in-out para movimiento en pantallaease-spring-natural- Usa animaciones con muelle para movimiento naturalease-ios-drawer- Usa easing al estilo iOS para componentes de cajónease-context-matters- Ajusta el easing al contexto de la animación
2. Sincronización y Duración (CRÍTICO)
timing-300ms-max- Mantén las animaciones de interfaz por debajo de 300mstiming-faster-better- Las animaciones más rápidas mejoran el rendimiento percibidotiming-asymmetric- Usa sincronización asimétrica para presionar y soltartiming-tooltip-delay- Retrasa los tooltips iniciales, instantáneos los siguientestiming-drawer-500ms- Usa una duración de 500ms para animaciones de cajón
3. Selección de Propiedades (ALTO)
props-transform-opacity- Anima solo transform y opacidadprops-hardware-accelerated- Usa animaciones aceleradas por hardware cuando el hilo principal esté ocupadoprops-will-change- Usa will-change para prevenir desplazamiento de 1pxprops-avoid-css-variables- Evita las variables CSS para animaciones de arrastreprops-clip-path-performant- Usa clip-path para revelaciones sin diseño
4. Técnicas de Transformación (ALTO)
transform-scale-097- Escala los botones a 0.97 al presionartransform-never-scale-zero- Nunca animes desde scale(0)transform-percentage-translate- Usa valores porcentuales para translateYtransform-origin-aware- Haz que las animaciones sean conscientes del origentransform-scale-children- Las transformaciones de escala afectan a los hijostransform-3d-preserve- Usa preserve-3d para efectos de transformación 3D
5. Patrones de Interacción (MEDIO-ALTO)
interact-interruptible- Haz que las animaciones sean interrumpiblesinteract-momentum-dismiss- Usa descarte basado en momentointeract-damping- Amortigua el arrastre en los límitesinteract-scroll-drag-conflict- Resuelve conflictos entre desplazamiento y arrastreinteract-snap-points- Implementa puntos de ajuste conscientes de la velocidadinteract-friction-upward- Permite el arrastre hacia arriba con friccióninteract-pointer-capture- Usa captura de puntero para operaciones de arrastre
6. Animación Estratégica (MEDIO)
strategy-keyboard-no-animate- Nunca animes acciones iniciadas por tecladostrategy-frequency-matters- Considera la frecuencia de interacción antes de animarstrategy-purpose-required- Cada animación debe tener un propósitostrategy-feedback-immediate- Proporciona retroalimentación inmediata en todas las accionesstrategy-marketing-exception- Los sitios de marketing son la excepción
7. Accesibilidad y Acabados (MEDIO)
polish-reduced-motion- Respeta prefers-reduced-motionpolish-opacity-fallback- Usa opacidad como alternativa para movimiento reducidopolish-framer-hook- Usa el hook useReducedMotion en Framer Motionpolish-dont-remove-all- No elimines todas las animaciones para movimiento reducidopolish-blur-bridge- Usa desenfoque para puentear estados de animaciónpolish-clip-path-tabs- Usa clip-path para transiciones de pestañaspolish-toast-stacking- Implementa apilamiento de toasts con escala y desplazamientopolish-scroll-reveal- Dispara animaciones de desplazamiento en el umbral adecuadopolish-hover-gap-fill- Rellena los espacios entre elementos hovereablespolish-stagger-children- Escalona animaciones de hijos para orquestación
Referencia de Valores Clave
| Valor | Uso |
|---|---|
cubic-bezier(0.32, 0.72, 0, 1) | Animación de cajón/hoja estilo iOS |
scale(0.97) | Retroalimentación de presión de botón |
scale(0.95) | Escala mínima de entrada (nunca scale(0)) |
200ms ease-out | Transición de interfaz estándar |
300ms | Duración máxima para animaciones de interfaz |
500ms | Duración de animación de cajón |
0.11 px/ms | Umbral de velocidad para descarte por momento |
100px | Umbral de viewport para revelación por desplazamiento |
14px | Desplazamiento de pila de toasts |
Archivos de Referencia
| Archivo | Descripción |
|---|---|
| references/_sections.md | Definiciones y orden de categorías |
| assets/templates/_template.md | Plantilla para nuevas reglas |
| metadata.json | Información de versión y referencia |