Communitygithub.com

Diseño de Interacción

Diseñar e implementar microinteracciones, diseño de movimiento, transiciones y patrones de retroalimentación para el usuario. Úsalo para añadir brillo a las interacciones de la interfaz, implementar estados de carga o crear experiencias de usuario encantadoras.

¿Qué es Diseño de Interacción?

Esta habilidad está diseñada para desarrolladores y agentes de IA que desean implementar interacciones de usuario pulidas y profesionales en aplicaciones web modernas. Proporciona un conjunto completo de patrones y principios para crear microinteracciones, transiciones de estado y animaciones que mejoran la usabilidad y deleitan a los usuarios. La habilidad se basa en bibliotecas populares como Framer Motion y CSS, y está estructurada en torno a principios fundamentales como movimiento con propósito y sincronización consistente. Incluye ejemplos de código prácticos para patrones de interacción comunes, incluyendo estados de carga, transiciones de página, gestos, efectos de retroalimentación (como ondas) y transiciones suaves de componentes. También aborda consideraciones de accesibilidad críticas, como el soporte para `prefers-reduced-motion`, y mejores prácticas de rendimiento (por ejemplo, animar solo `transform` y `opacity`). La habilidad es aplicable a cualquier plataforma que soporte React (como Next.js, Vite) y puede adaptarse a otras configuraciones de UI. Los agentes que utilizan esta habilidad pueden generar, depurar y refinar interacciones siguiendo las pautas documentadas, asegurando que el producto final sea rápido, accesible y visualmente atractivo.

Compatible con~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/itsmeyaw/skillset-website/tree/HEAD/.agents/skills/interaction-design

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Diseño de Interacción?

Crea interacciones atractivas e intuitivas a través de movimiento, retroalimentación y transiciones de estado reflexivas que mejoran la usabilidad y deleitan a los usuarios.

Cuándo Usar Esta Habilidad

  • Agregar microinteracciones para mejorar la retroalimentación del usuario
  • Implementar transiciones suaves de páginas y componentes
  • Diseñar estados de carga y pantallas esqueleto
  • Crear interacciones basadas en gestos
  • Construir sistemas de notificaciones y toasts
  • Implementar interfaces de arrastrar y soltar
  • Agregar animaciones activadas por desplazamiento
  • Diseñar estados de hover y focus

Principios Fundamentales

1. Movimiento con Propósito

El movimiento debe comunicar, no decorar:

  • Retroalimentación: Confirmar que las acciones del usuario ocurrieron
  • Orientación: Mostrar de dónde vienen y a dónde van los elementos
  • Enfoque: Dirigir la atención a cambios importantes
  • Continuidad: Mantener el contexto durante las transiciones

2. Pautas de Temporización

DuraciónCaso de Uso
100-150msMicro retroalimentación (hovers, clics)
200-300msTransiciones pequeñas (toggles, menús)
300-500msTransiciones medianas (modales, cambios de página)
500ms+Animaciones coreografiadas complejas

3. Funciones de Atenuación

/* Atenuaciones comunes */
--ease-out: cubic-bezier(0.16, 1, 0.3, 1); /* Desacelerar - al entrar */
--ease-in: cubic-bezier(0.55, 0, 1, 0.45); /* Acelerar - al salir */
--ease-in-out: cubic-bezier(0.65, 0, 0.35, 1); /* Ambos - al moverse entre */
--spring: cubic-bezier(0.34, 1.56, 0.64, 1); /* Sobrepasar - juguetón */

Inicio Rápido: Microinteracción de Botón

import { motion } from "framer-motion";

export function InteractiveButton({ children, onClick }) {
  return (
    <motion.button
      onClick={onClick}
      whileHover={{ scale: 1.02 }}
      whileTap={{ scale: 0.98 }}
      transition={{ type: "spring", stiffness: 400, damping: 17 }}
      className="px-4 py-2 bg-blue-600 text-white rounded-lg"
    >
      {children}
    </motion.button>
  );
}

Patrones de Interacción

1. Estados de Carga

Pantallas Esqueleto: Preservar el diseño mientras se carga

function CardSkeleton() {
  return (
    <div className="animate-pulse">
      <div className="h-48 bg-gray-200 rounded-lg" />
      <div className="mt-4 h-4 bg-gray-200 rounded w-3/4" />
      <div className="mt-2 h-4 bg-gray-200 rounded w-1/2" />
    </div>
  );
}

Indicadores de Progreso: Mostrar progreso determinado

function ProgressBar({ progress }: { progress: number }) {
  return (
    <div className="h-2 bg-gray-200 rounded-full overflow-hidden">
      <motion.div
        className="h-full bg-blue-600"
        initial={{ width: 0 }}
        animate={{ width: `${progress}%` }}
        transition={{ ease: "easeOut" }}
      />
    </div>
  );
}

2. Transiciones de Estado

Toggle con transición suave:

function Toggle({ checked, onChange }) {
  return (
    <button
      role="switch"
      aria-checked={checked}
      onClick={() => onChange(!checked)}
      className={`
        relative w-12 h-6 rounded-full transition-colors duration-200
        ${checked ? "bg-blue-600" : "bg-gray-300"}
      `}
    >
      <motion.span
        className="absolute top-1 left-1 w-4 h-4 bg-white rounded-full shadow"
        animate={{ x: checked ? 24 : 0 }}
        transition={{ type: "spring", stiffness: 500, damping: 30 }}
      />
    </button>
  );
}

3. Transiciones de Página

Animaciones de diseño con Framer Motion:

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

function PageTransition({ children, key }) {
  return (
    <AnimatePresence mode="wait">
      <motion.div
        key={key}
        initial={{ opacity: 0, y: 20 }}
        animate={{ opacity: 1, y: 0 }}
        exit={{ opacity: 0, y: -20 }}
        transition={{ duration: 0.3 }}
      >
        {children}
      </motion.div>
    </AnimatePresence>
  );
}

4. Patrones de Retroalimentación

Efecto de onda al hacer clic:

function RippleButton({ children, onClick }) {
  const [ripples, setRipples] = useState([]);

  const handleClick = (e) => {
    const rect = e.currentTarget.getBoundingClientRect();
    const ripple = {
      x: e.clientX - rect.left,
      y: e.clientY - rect.top,
      id: Date.now(),
    };
    setRipples((prev) => [...prev, ripple]);
    setTimeout(() => {
      setRipples((prev) => prev.filter((r) => r.id !== ripple.id));
    }, 600);
    onClick?.(e);
  };

  return (
    <button onClick={handleClick} className="relative overflow-hidden">
      {children}
      {ripples.map((ripple) => (
        <span
          key={ripple.id}
          className="absolute bg-white/30 rounded-full animate-ripple"
          style={{ left: ripple.x, top: ripple.y }}
        />
      ))}
    </button>
  );
}

5. Interacciones por Gestos

Deslizar para descartar:

function SwipeCard({ children, onDismiss }) {
  return (
    <motion.div
      drag="x"
      dragConstraints={{ left: 0, right: 0 }}
      onDragEnd={(_, info) => {
        if (Math.abs(info.offset.x) > 100) {
          onDismiss();
        }
      }}
      className="cursor-grab active:cursor-grabbing"
    >
      {children}
    </motion.div>
  );
}

Patrones de Animación CSS

Animaciones con Keyframes

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

@keyframes pulse {
  0%,
  100% {
    opacity: 1;
  }
  50% {
    opacity: 0.5;
  }
}

@keyframes spin {
  to {
    transform: rotate(360deg);
  }
}

.animate-fadeIn {
  animation: fadeIn 0.3s ease-out;
}
.animate-pulse {
  animation: pulse 2s ease-in-out infinite;
}
.animate-spin {
  animation: spin 1s linear infinite;
}

Transiciones CSS

.card {
  transition:
    transform 0.2s ease-out,
    box-shadow 0.2s ease-out;
}

.card:hover {
  transform: translateY(-4px);
  box-shadow: 0 12px 24px rgba(0, 0, 0, 0.1);
}

Consideraciones de Accesibilidad

/* Respetar las preferencias de movimiento del usuario */
@media (prefers-reduced-motion: reduce) {
  *,
  *::before,
  *::after {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
  }
}
function AnimatedComponent() {
  const prefersReducedMotion = window.matchMedia(
    "(prefers-reduced-motion: reduce)",
  ).matches;

  return (
    <motion.div
      animate={{ opacity: 1 }}
      transition={{ duration: prefersReducedMotion ? 0 : 0.3 }}
    />
  );
}

Mejores Prácticas

  1. Rendimiento Primero: Usar transform y opacity para 60 fps suaves
  2. Soporte de Movimiento Reducido: Respetar siempre prefers-reduced-motion
  3. Temporización Consistente: Usar una escala de tiempos en toda la aplicación
  4. Física Natural: Preferir animaciones spring sobre lineales
  5. Interrumpible: Permitir a los usuarios cancelar animaciones largas
  6. Mejora Progresiva: Funcionar sin animaciones JS
  7. Probar en Dispositivos: El rendimiento varía significativamente

Problemas Comunes

  • Animaciones Entrecortadas: Evitar animar width, height, top, left
  • Sobre-animación: Demasiado movimiento causa fatiga
  • Interacciones Bloqueantes: Nunca impedir la entrada del usuario durante animaciones
  • Fugas de Memoria: Limpiar los listeners de animación al desmontar
  • Destello de Contenido: Usar will-change con moderación para optimización

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados