Communitygithub.com

design-de-interacao

Projete e implemente microinterações, design de movimento, transições e padrões de feedback do usuário. Use ao adicionar polimento a interações de UI, implementar estados de carregamento ou criar experiências de usuário encantadoras.

O que é design-de-interacao?

Esta habilidade oferece um guia abrangente para projetar e implementar interações de alta qualidade em interfaces de usuário, com foco em microinterações, motion design, transições suaves e padrões de feedback. É útil para desenvolvedores que desejam adicionar polimento às suas aplicações, melhorando a experiência do usuário com animações significativas, estados de carregamento (como skeleton screens) e interações gestuais. A habilidade suporta plataformas web modernas e fornece exemplos práticos em React com Framer Motion, além de padrões CSS (keyframes e transições). Os princípios fundamentais incluem o uso de movimento proposital (feedback, orientação, foco, continuidade), diretrizes de temporização (de 100ms para micro-feedback a 500ms+ para animações coreografadas) e funções de easing adequadas. Também aborda considerações de acessibilidade, como o respeito à preferência `prefers-reduced-motion`, e melhores práticas para desempenho, como animar apenas `transform` e `opacity` para atingir 60fps suaves. Os desenvolvedores podem usar os padrões prontos para uso para criar botões com feedback tátil, alternâncias suaves, transições de página, efeitos de ondulação (ripple) e gestos de deslizar para dispensar.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Design de Interação

Crie interações envolventes e intuitivas por meio de movimento, feedback e transições de estado cuidadosas que melhoram a usabilidade e encantam os usuários.

Quando Usar Esta Habilidade

  • Adicionar microinterações para melhorar o feedback do usuário
  • Implementar transições suaves de página e de componentes
  • Projetar estados de carregamento e telas esqueleto
  • Criar interações baseadas em gestos
  • Construir sistemas de notificação e toast
  • Implementar interfaces de arrastar e soltar
  • Adicionar animações acionadas por rolagem
  • Projetar estados de hover e foco

Princípios Fundamentais

1. Movimento Proposital

O movimento deve comunicar, não decorar:

  • Feedback: Confirmar que as ações do usuário ocorreram
  • Orientação: Mostrar de onde os elementos vêm/para onde vão
  • Foco: Direcionar a atenção para mudanças importantes
  • Continuidade: Manter o contexto durante as transições

2. Diretrizes de Temporização

DuraçãoCaso de Uso
100-150msMicro-feedback (hovers, cliques)
200-300msTransições pequenas (alternâncias, menus)
300-500msTransições médias (modais, mudanças de página)
500ms+Animações coreografadas complexas

3. Funções de Easing

/* Easing comuns */
--ease-out: cubic-bezier(0.16, 1, 0.3, 1); /* Desacelerar - entrada */
--ease-in: cubic-bezier(0.55, 0, 1, 0.45); /* Acelerar - saída */
--ease-in-out: cubic-bezier(0.65, 0, 0.35, 1); /* Ambos - movendo entre */
--spring: cubic-bezier(0.34, 1.56, 0.64, 1); /* Ultrapassagem - lúdico */

Início Rápido: Microinteração de Botão

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>
  );
}

Padrões de Interação

1. Estados de Carregamento

Telas Esqueleto: Preservar o layout durante o carregamento

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 Progresso: Mostrar progresso 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. Transições de Estado

Alternância com transição 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. Transições de Página

Animações de layout com 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. Padrões de Feedback

Efeito de ondulação ao clicar:

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. Interações Gestuais

Deslizar para dispensar:

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>
  );
}

Padrões de Animação CSS

Animações com 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;
}

Transições 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);
}

Considerações de Acessibilidade

/* Respeitar as preferências de movimento do usuário */
@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 }}
    />
  );
}

Melhores Práticas

  1. Desempenho em Primeiro Lugar: Use transform e opacity para 60fps suaves
  2. Suporte a Movimento Reduzido: Sempre respeite prefers-reduced-motion
  3. Temporização Consistente: Use uma escala de temporização em todo o aplicativo
  4. Física Natural: Prefira animações spring em vez de lineares
  5. Interruptível: Permita que os usuários cancelem animações longas
  6. Melhoria Progressiva: Funcione sem animações JS
  7. Teste em Dispositivos: O desempenho varia significativamente

Problemas Comuns

  • Animações Instáveis: Evite animar width, height, top, left
  • Excesso de Animação: Muito movimento causa fadiga
  • Interações Bloqueadoras: Nunca impeça a entrada do usuário durante animações
  • Vazamentos de Memória: Limpe os listeners de animação ao desmontar
  • Flash de Conteúdo: Use will-change com moderação para otimização

Individual skills in this repo

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

Habilidades Relacionadas