Communitygithub.com

TheMystic07/OpenWalc

Diseño de movimiento y animación para interfaces de usuario. Útil al crear microinteracciones, transiciones de página, estados de carga o cualquier animación de UI en plataformas web y móviles.

¿Qué es OpenWalc?

Esta habilidad es una guía integral para crear animaciones en interfaces de usuario que sean deliberadas, funcionales y de alto rendimiento. Enseña a aplicar los 12 principios clásicos de animación al contexto de la UI, con directrices claras sobre duraciones según la distancia, funciones de easing (como ease-out, ease-in, y curvas personalizadas) y patrones de animación comunes como microinteracciones, estados de carga, transiciones de página y listas escalonadas. También cubre aspectos críticos de rendimiento, como el uso de propiedades aceleradas por GPU (transform y opacity) y la técnica FLIP para animaciones eficientes de diseño. Incluye ejemplos prácticos con tecnologías como CSS, Framer Motion y GSAP, así como pautas de accesibilidad (prefers-reduced-motion) y consideraciones específicas para plataformas móviles (iOS y Android). Es compatible con cualquier proyecto que use HTML/CSS/JavaScript o frameworks modernos como React.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TheMystic07/OpenWalc/tree/HEAD/.agent/skills/ui-animation

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Animación UI y Diseño de Movimiento

Guía completa para crear animaciones con propósito y rendimiento en interfaces de usuario.

Principios de Animación

Los 12 Principios de Animación (Aplicados a UI)

PrincipioAplicación en UI
TimingLa duración refleja importancia/distancia
EasingAceleración/desaceleración natural
AnticipaciónPreparación visual para una acción
SobrepasoEl momento continúa después de detenerse
Acción SecundariaLos elementos de apoyo reaccionan
Puesta en escenaDirigir la atención a un elemento clave
Estirar y EncogerInteracciones elásticas y divertidas
ExageraciónEnfatizar comentarios importantes
ArcoTrayectorias curvas naturales
SuperposiciónElementos se mueven a diferentes ritmos
Dibujo SólidoMantener un espacio 3D consistente
AtractivoMovimiento atractivo y placentero

¿Por Qué Animar?

PROPÓSITOS FUNCIONALES:
✓ Guiar la atención hacia cambios importantes
✓ Mostrar relaciones entre elementos
✓ Proporcionar retroalimentación para acciones
✓ Comunicar el estado del sistema
✓ Reducir la carga cognitiva
✓ Crear orientación espacial

NO PARA:
✗ Decoración pura
✗ Lucir habilidades
✗ Hacer que las cosas "se sientan modernas"
✗ Distraer del contenido

Timing y Duración

Guías de Duración

INSTANTÁNEO (0-100ms):
└─→ Cambios de estado de botones
└─→ Interruptores de alternar
└─→ Micro-retroalimentación

RÁPIDO (100-200ms):
└─→ Efectos hover
└─→ Desvanecidos simples
└─→ Movimientos pequeños

ESTÁNDAR (200-300ms):
└─→ La mayoría de transiciones UI
└─→ Apertura/cierre de modales
└─→ Menús desplegables

LENTO (300-500ms):
└─→ Transiciones complejas
└─→ Transiciones de página
└─→ Movimiento de elementos grandes

DELIBERADO (500ms+):
└─→ Animaciones de héroe
└─→ Carga con esqueleto
└─→ Secuencias de incorporación

Timing Basado en Distancia

Regla: Mayor distancia = Mayor duración

Pequeña (< 100px):   150-200ms
Mediana (100-300px):  200-300ms
Grande (300-500px):   300-400ms
Pantalla completa:    400-500ms

Fórmula:
duración = tiempoBase + (distancia × factor)

Funciones de Easing

Easings Estándar

LINEAL
├────────────────────────────┤
Velocidad constante. Rara vez natural.
Uso: Barras de progreso, manecillas de reloj

EASE-OUT (Desaceleración)
├═══════════────────────────┤
Inicio rápido, final lento.
Uso: Elementos entrando en pantalla

EASE-IN (Aceleración)
├────────────────═══════════┤
Inicio lento, final rápido.
Uso: Elementos saliendo de pantalla

EASE-IN-OUT (Curva S)
├────═══════════════────────┤
Inicio y final lentos, medio rápido.
Uso: Transiciones en pantalla

EASE-OUT-BACK (Sobreimpulso)
├═══════════────────────╗───┤
Sobreimpulsa y se asienta.
Uso: Entradas divertidas, rebotes

Valores CSS de Easing

/* Palabras clave incorporadas */
linear: cubic-bezier(0, 0, 1, 1)
ease: cubic-bezier(0.25, 0.1, 0.25, 1)
ease-in: cubic-bezier(0.42, 0, 1, 1)
ease-out: cubic-bezier(0, 0, 0.58, 1)
ease-in-out: cubic-bezier(0.42, 0, 0.58, 1)

/* Estándar de Material Design */
standard: cubic-bezier(0.4, 0, 0.2, 1)
decelerate: cubic-bezier(0, 0, 0.2, 1)
accelerate: cubic-bezier(0.4, 0, 1, 1)

/* Personalizado: Enérgico */
snappy: cubic-bezier(0.5, 0, 0, 1)

/* Personalizado: Elástico */
bouncy: cubic-bezier(0.68, -0.55, 0.27, 1.55)

/* Similar a resorte (usar librerías JS) */
spring: { stiffness: 300, damping: 20 }

Cuándo Usar Cada Uno

EscenarioEasingPor Qué
Elemento entrandoease-outLlega enérgicamente, se asienta
Elemento saliendoease-inGana impulso para salir
Cambio en pantallaease-in-outTransición de estado suave
Llamar la atenciónbounce/springDivertido, notable
Fondo/sutilease-outDiscreto

Patrones de Animación

Micro-interacciones

ESTADOS DE BOTÓN:
┌─────────────────────────────────────────┐
│ Reposo → Hover: scale(1.02), 100ms       │
│ Hover → Activo: scale(0.98), 50ms       │
│ Activo → Reposo: scale(1), 150ms ease-out │
└─────────────────────────────────────────┘

INTERRUPTOR DE ALTERNAR:
┌─────────────────────────────────────────┐
│ Pulgar: translateX, 200ms ease-out      │
│ Pista: background-color, 200ms          │
│ Estado: ligero rebote al final          │
└─────────────────────────────────────────┘

CASILLA DE VERIFICACIÓN:
┌─────────────────────────────────────────┐
│ Marca: animación stroke-dashoffset      │
│ Fondo: escala desde el centro, 150ms    │
│ Onda: círculo expansivo, 300ms          │
└─────────────────────────────────────────┘

Estados de Carga

PANTALLAS DE ESQUELETO:
┌──────────────────────────┐
│ ▓▓▓▓▓▓▓▓▓▓░░░░░░░░░░░░  │ Efecto de brillo
│ ▓▓▓▓▓▓▓▓▓▓▓▓░░░░░░░░░░  │ Gradiente lineal
│ ▓▓▓▓▓▓░░░░░░░░░░░░░░░░  │ Moviéndose izquierda a derecha
└──────────────────────────┘

CSS:
background: linear-gradient(
  90deg,
  #f0f0f0 25%,
  #e0e0e0 50%,
  #f0f0f0 75%
);
background-size: 200% 100%;
animation: shimmer 1.5s infinite;

SPINNER:
- Duración: 1-2 segundos por rotación
- Easing: lineal (movimiento consistente)
- Estilo: Alineado con la identidad de la marca

Transiciones de Página

CRUCE DE DESVANECIDO (CROSSFADE):
├──────────────────────────────────────────┤
│ Página antigua: opacidad 1 → 0, 200ms   │
│ Página nueva: opacidad 0 → 1, 200ms     │
│ Timing: secuencial o superpuesto         │
└──────────────────────────────────────────┘

DESLIZAMIENTO (SLIDE):
├──────────────────────────────────────────┤
│ La dirección sigue la jerarquía de navegación│
│ Adelante: deslizar izquierda (nuevo desde derecha)│
│ Atrás: deslizar derecha (anterior desde izquierda)│
│ Duración: 300-400ms                      │
└──────────────────────────────────────────┘

ELEMENTO COMPARTIDO:
├──────────────────────────────────────────┤
│ El elemento se transforma entre estados  │
│ Posición, tamaño, border-radius cambian  │
│ Crea continuidad entre pantallas         │
│ Duración: 300-500ms                      │
└──────────────────────────────────────────┘

Animaciones de Listas

ENTRADA ESCALONADA:
┌─ Elemento 1 ──────────────┐  delay: 0ms
├─ Elemento 2 ──────────────┤  delay: 50ms
├─ Elemento 3 ──────────────┤  delay: 100ms
├─ Elemento 4 ──────────────┤  delay: 150ms
└─ Elemento 5 ──────────────┘  delay: 200ms

Duración máxima total: 500ms
Escalonamiento: 30-50ms por elemento
Animación: translateY + opacidad

REORDENAMIENTO:
- Usar técnica FLIP
- Duración: 200-300ms
- Ease: ease-out

Rendimiento

Propiedades Aceleradas por GPU

RÁPIDO (Solo compositor):
✓ transform: translate, scale, rotate
✓ opacity
✓ filter (con will-change)

LENTO (Activa layout/pintado):
✗ width, height
✗ margin, padding
✗ top, left, right, bottom
✗ border, border-radius
✗ font-size
✗ box-shadow (repite pintado)

OPTIMIZACIÓN:
will-change: transform, opacity;
/* ¡Usar con moderación! */

Guías de Rendimiento

/* Bueno: Acelerado por GPU */
.elemento-animado {
  transform: translateX(0);
  transition: transform 300ms ease-out;
}
.elemento-animado.movido {
  transform: translateX(100px);
}

/* Malo: Golpeteo de layout */
.elemento-animado {
  left: 0;
  transition: left 300ms ease-out;
}
.elemento-animado.movido {
  left: 100px;
}

Técnica FLIP

// Primero: Obtener posición inicial
const first = element.getBoundingClientRect();

// Último: Aplicar cambio, obtener posición final
element.classList.add("moved");
const last = element.getBoundingClientRect();

// Invertir: Calcular delta, aplicar transformación inversa
const deltaX = first.left - last.left;
const deltaY = first.top - last.top;
element.style.transform = `translate(${deltaX}px, ${deltaY}px)`;

// Reproducir: Eliminar transformación con transición
requestAnimationFrame(() => {
  element.style.transition = "transform 300ms ease-out";
  element.style.transform = "";
});

Técnicas de Animación CSS

Animación con Keyframes

@keyframes fadeSlideIn {
  from {
    opacity: 0;
    transform: translateY(20px);
  }
  to {
    opacity: 1;
    transform: translateY(0);
  }
}

.elemento {
  animation: fadeSlideIn 300ms ease-out forwards;
}

/* Con pasos */
@keyframes maquinaEscribir {
  from {
    width: 0;
  }
  to {
    width: 100%;
  }
}

.texto-escrito {
  animation: maquinaEscribir 2s steps(20) forwards;
}

Transición

.boton {
  background: var(--primary);
  transform: scale(1);
  transition:
    background 150ms ease-out,
    transform 100ms ease-out;
}

.boton:hover {
  background: var(--primary-hover);
  transform: scale(1.02);
}

.boton:active {
  transform: scale(0.98);
  transition-duration: 50ms;
}

Abreviatura de Animación

/* animation: nombre duración función-de-timing retraso
              recuento-de-iteraciones dirección modo-de-relleno estado-de-reproducción */

animation: slideIn 300ms ease-out 100ms 1 normal forwards running;

/* Patrones comunes */
animation: spin 1s linear infinite;
animation: pulse 2s ease-in-out infinite alternate;
animation: fadeIn 300ms ease-out forwards;

Librerías de Animación JavaScript

Comparación

LibreríaMejor ParaTamaño del Bundle
CSSTransiciones simples0kb
Web Animations APINativo, de alto rendimiento0kb
GSAPComplejo, preciso~60kb
Framer MotionEcosistema React~50kb
anime.jsLínea de tiempo, SVG~17kb
Motion OneModerno, ligero~18kb
LottieExportación desde After Effects~50kb

Framer Motion (React)

import { motion, AnimatePresence } from "framer-motion";

// Animación básica
<motion.div
  initial={{ opacity: 0, y: 20 }}
  animate={{ opacity: 1, y: 0 }}
  exit={{ opacity: 0, y: -20 }}
  transition={{ duration: 0.3, ease: "easeOut" }}
>
  Contenido
</motion.div>;

// Variantes para animaciones complejas
const variantesContenedor = {
  hidden: { opacity: 0 },
  visible: {
    opacity: 1,
    transition: {
      staggerChildren: 0.1,
    },
  },
};

const variantesElemento = {
  hidden: { opacity: 0, y: 20 },
  visible: { opacity: 1, y: 0 },
};

<motion.ul variants={variantesContenedor} initial="hidden" animate="visible">
  {items.map((item) => (
    <motion.li key={item.id} variants={variantesElemento}>
      {item.name}
    </motion.li>
  ))}
</motion.ul>;

GSAP

import { gsap } from "gsap";

// Tween básico
gsap.to(".elemento", {
  x: 100,
  opacity: 1,
  duration: 0.3,
  ease: "power2.out",
});

// Línea de tiempo
const tl = gsap.timeline();
tl.from(".header", { y: -100, duration: 0.5 })
  .from(".content", { opacity: 0, duration: 0.3 }, "-=0.2")
  .from(".button", { scale: 0.8, duration: 0.2 });

// ScrollTrigger
gsap.registerPlugin(ScrollTrigger);
gsap.to(".parallax", {
  y: -100,
  scrollTrigger: {
    trigger: ".section",
    start: "top center",
    end: "bottom center",
    scrub: true,
  },
});

Accesibilidad

Respetando las Preferencias del Usuario

/* Reducir movimiento para usuarios que lo prefieren */
@media (prefers-reduced-motion: reduce) {
  *,
  *::before,
  *::after {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
  }
}

/* O proporcionar alternativas más simples */
@media (prefers-reduced-motion: reduce) {
  .elemento-animado {
    /* Reemplazar movimiento con opacidad */
    animation: none;
    transition: opacity 200ms ease;
  }
}

Prácticas Seguras de Animación

EVITAR para trastornos vestibulares:
✗ Efectos de desplazamiento parallax
✗ Animaciones de zoom/escalado
✗ Elementos giratorios/rotativos
✗ Animaciones que se reproducen automáticamente
✗ Destellos (>3 veces/segundo)

Alternativas SEGURAS:
✓ Desvanecimientos de opacidad
✓ Transiciones de color
✓ Cambios de posición sutiles
✓ Animaciones iniciadas por el usuario

Pautas WCAG

2.2.2 Pausar, Detener, Ocultar:
- El contenido que se actualiza automáticamente se puede pausar
- Sin límites de tiempo para la lectura

2.3.1 Tres Destellos:
- Nada destella más de 3 veces por segundo

2.3.3 Animación de Interacciones:
- El movimiento se puede deshabilitar
- Las animaciones activadas respetan las preferencias

Consideraciones para Móviles

Retroalimentación Táctil

/* Estilo táctil similar a iOS */
.boton {
  -webkit-tap-highlight-color: transparent;
  touch-action: manipulation;
}

.boton:active {
  opacity: 0.7;
  transition: opacity 50ms;
}

/* Efecto de onda */
.onda {
  position: relative;
  overflow: hidden;
}

.onda::after {
  content: "";
  position: absolute;
  background: rgba(255, 255, 255, 0.3);
  border-radius: 50%;
  transform: scale(0);
  animation: onda 400ms ease-out;
}

Convenciones de Plataforma

PlataformaEstilo de Animación
iOSFísica de resorte, 300-500ms, sutil
AndroidMovimiento Material, 200-300ms, enfatizado
WebVaría, típicamente 200-400ms

Integración con el Sistema de Diseño

Tokens de Animación

:root {
  /* Duraciones */
  --duration-instant: 100ms;
  --duration-fast: 150ms;
  --duration-normal: 250ms;
  --duration-slow: 400ms;
  --duration-slower: 600ms;

  /* Easings */
  --ease-default: cubic-bezier(0.4, 0, 0.2, 1);
  --ease-in: cubic-bezier(0.4, 0, 1, 1);
  --ease-out: cubic-bezier(0, 0, 0.2, 1);
  --ease-bounce: cubic-bezier(0.68, -0.55, 0.27, 1.55);

  /* Combinados */
  --transition-default: var(--duration-normal) var(--ease-default);
  --transition-fast: var(--duration-fast) var(--ease-out);
}

/* Uso */
.elemento {
  transition: transform var(--transition-default);
}

Mejores Prácticas

HACER:

  • Animar con propósito (retroalimentación, guía)
  • Usar propiedades aceleradas por GPU
  • Mantener duraciones por debajo de 500ms
  • Igualar la animación con la personalidad de la marca
  • Respetar prefers-reduced-motion
  • Probar en dispositivos de gama baja
  • Usar un sistema de timing consistente

NO HACER:

  • Animar solo por decoración
  • Bloquear la interacción del usuario
  • Usar rebotes/sobreimpulsos excesivos
  • Crear desencadenantes de mareo por movimiento
  • Olvidar las animaciones de salida
  • Ignorar las métricas de rendimiento

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Skills relacionados