¿Qué hace Motion UI?
Un manual basado en investigación para el movimiento y los gestos en la interfaz de usuario de producto: 19 archivos de patrones, cada uno con reglas, antipatrones, referencias buenas y malas, accesibilidad, tokens, un bosquejo de implementación y una lista de verificación. Este archivo proporciona el flujo de trabajo, los no negociables, las tablas de decisión y los valores predeterminados de los tokens. Abre los archivos de patrón para obtener profundidad.
- Índice de patrones:
references/INDEX.mdenumera cada patrón con su regla de una línea. - Archivos de patrón:
references/patterns/<prefijo>-<nombre>.md. Los prefijos sonmfound(propósito, temporización, coreografía, movimiento reducido),mspring(muelles),mgesture(arrastre, impulso, bordes, paneles, interrupción),mtrans(entrada/salida, origen espacial, transiciones de ruta, microinteracciones, animaciones basadas en scroll),mperf(rendimiento) ymref(rúbrica de revisión, antipatrones). - Tokens de inicio:
assets/motion-tokens.css. Los nombres y valores de duración, easing y retardo coinciden contokens.cssde dashboard-ui. Funciona por sí solo en modo claro y oscuro: los tokens de rol de dashboard-ui que lee se declaran con especificidad cero, por lo quetokens.cssde dashboard-ui o los tokens propios del proyecto con los mismos nombres de rol los anulan en cualquier orden de carga. - UI de datos: para interpolación de números, transiciones de gráficos, exploración enlazada, recálculo en vivo y estados de carga, usa los patrones
motion-*yprog-*de dashboard-ui. Esta habilidad no los repite.
Flujo de trabajo
- Decide si debe moverse. Nombra el trabajo: retroalimentación, continuidad, orientación, atención o (rara vez) deleite. Estima con qué frecuencia ocurre y si se activa desde el teclado, luego elige la fila en la tabla de frecuencias a continuación (
mfound-propósito-y-frecuencia.md). Si no hay trabajo, o la acción se activa por teclado u ocurre 100+ veces al día, detente: no hay animación. - Elige el mecanismo.
- De reposo a reposo y conmutado (menús, diálogos, conmutadores): una transición CSS (
mfound-duraciones-y-easing.md), o un token de muellelinear()CSS (mspring-css-linear-y-tokens.md). - Impulsado por un dedo o puntero, o interrumpible con velocidad: un muelle JS (
mspring-parámetros-y-mapeo.md,mgesture-interrumpibilidad-y-velocidad.md). - Navegación: View Transitions (
mtrans-view-transitions-y-rutas.md). - Vinculado a la posición de scroll: animación basada en scroll (
mtrans-animaciones-basadas-en-scroll.md).
- De reposo a reposo y conmutado (menús, diálogos, conmutadores): una transición CSS (
- Establece la temporización a partir de los tokens. Duración por elemento, easing según la dirección, salidas a 0,75× la entrada, y muelles como duración más rebote. Nunca uses valores sin procesar en los componentes.
- Colócalo en el espacio. Usa
transform-originen el disparador, refleja las salidas, mantén la coherencia entre avance y retroceso, y deja que el chrome persistente permanezca quieto (mtrans-origen-espacial-y-continuidad.md). Para la entrada/salida de elementos en la capa superior, siguemtrans-entrada-salida-capa-superior.md. - Para gestos, aplica en orden:
- Seguimiento 1:1 con un umbral de 10 px (
mgesture-manipulación-directa-arrastre.md); - Proyección y velocidad al soltar (
mgesture-impulso-proyección-y-snap.md); - Bordes con banda elástica (
mgesture-banda-elástica-y-límites.md); - Las reglas de paneles y deslizamiento para descartar (
mgesture-paneles-y-deslizar-para-descartar.md).
- Seguimiento 1:1 con un umbral de 10 px (
- Coreografía cuando cambian varias cosas: causa primero, luego padre, luego hijos; retardo de 20–40 ms, con límite (
mfound-coreografía-y-retardo.md). - Hazlo económico. Anima solo transform y opacidad, no uses
will-changeglobal, y pinta la retroalimentación en el siguiente frame (mperf-compositor-will-change-e-inp.md). - Escribe la versión de movimiento reducido como sustituciones, no eliminaciones (
mfound-movimiento-reducido-vestibular.md). - Revisa a partir de frames.
- Ejecuta la pasada de antipatrones (
mref-galería-de-antipatrones.md). - Captura tiras de frames (ralentizado 4×, movimiento completo y reducido, además de una ejecución interrumpida) y la auditoría en página.
- Puntúa la rúbrica de 18 comprobaciones (
mref-rúbrica-de-revisión-de-movimiento.md). Publica con un 80% o más y sin ninguna comprobación obligatoria en 0. - Informa cada hallazgo como ID de comprobación · evidencia · corrección, además de lo que no comprobaste.
- Ejecuta la pasada de antipatrones (
No negociables
Rompe uno de estos solo con una razón por escrito.
Si y cuánto tiempo
- Cada animación tiene un trabajo nombrado. Las acciones activadas por teclado y las de 100+/día no tienen animación.
- La primera respuesta visual llega dentro de los 100 ms posteriores a la entrada, independientemente de la duración de la animación.
- Las duraciones provienen de los tokens (100 / 150 / 240 / 400 ms). Nada en el chrome de la UI supera los 400 ms; solo los momentos raros pueden alcanzar los 600 ms.
- Las entradas se desaceleran; los movimientos en pantalla se aceleran y desaceleran; no hay
ease-inen nada que el usuario espere. Las salidas son aproximadamente 0,75× la entrada.
Muelles y gestos
- Los muelles se escriben como duración + rebote. Usa rebote 0 para el chrome de la UI, 0,1–0,2 solo después de un gesto con impulso, y nunca en opacidad, color o valores de datos.
- Los elementos arrastrados siguen el puntero 1:1 desde el punto de agarre, sin transición durante el arrastre. Comprométete con un arrastre después de aproximadamente 10 px.
- Al soltar, ajusta al destino más cercano a la posición proyectada e inicia el muelle de asentamiento con la velocidad de liberación.
- Los bordes tienen banda elástica; nada se detiene bruscamente bajo el dedo.
- Todo lo que el usuario puede afectar es interrumpible desde su valor actual en pantalla. No hay colas de animación ni entrada bloqueada durante el movimiento. La UI conmutada usa transiciones, no keyframes.
- Las acciones gestuales destructivas se confirman al soltar y ofrecen deshacer. Cada gesto tiene un botón o equivalente de teclado (WCAG 2.5.7).
Entrada, salida y navegación
- Nunca comiences desde
scale(0). Entra desde opacidad 0 más escala 0,95–0,97 o 8–24 px de desplazamiento, contransform-originen el disparador. - Usa
@starting-stylepara la entrada ydisplay/overlayconallow-discretepara la salida. El estado final visible es el predeterminado, por lo que los navegadores no compatibles aún funcionan. - Las transiciones de ruta son mejora progresiva. Prepara los datos primero, luego transiciona. Usa el fundido cruzado predeterminado o un desplazamiento direccional de 16–24 px según el tipo de transición, nombra 1–3 elementos compartidos y mueve el foco después.
- Los toasts nunca contienen la única copia de la información. Los errores nunca se descartan automáticamente; un toast de Deshacer permanece al menos 8 s y su acción también existe fuera del toast. Los temporizadores se pausan al pasar el ratón, al enfocar y en pestañas ocultas (
dashboard-ui/comp-notificaciones-alertas.md).
Rendimiento y seguridad
- Anima solo las propiedades de la familia transform y la opacidad en cualquier cosa más grande que un control pequeño. No hay
transition: all.will-changees temporal y solo sigue a una medición. - Bajo
prefers-reduced-motion: reduce, reemplaza el movimiento espacial con un fundido de 150 ms o menos, mantén la retroalimentación, mantén el seguimiento de arrastre 1:1 y elimina el rebote. Nunca envíes un interruptor global0.01ms, y la animación JS también debe respetar la configuración. - Sin paralaje, secuestro de scroll, zoom de ventana completa o movimiento en bucle inactivo en la UI del producto. La reproducción automática de más de 5 s tiene un control de pausa, y nada parpadea más de 3 veces por segundo.
- Revisa el movimiento a partir de frames capturados, no del código o la memoria.
Tablas de decisión
Frecuencia → movimiento (mfound-propósito-y-frecuencia.md)
| Frecuencia | Movimiento |
|---|---|
| Activado por teclado, o 100+ veces al día (límite de la habilidad) | Ninguno |
| Decenas de veces al día | Fundido de 100–150 ms, tal vez una pequeña escala; sin movimiento, sin rebote |
| Algunas veces por sesión | 150–240 ms, puede moverse 8–24 px |
| Raro (primera ejecución, gran éxito) | Hasta 400–600 ms, un muelle con rebote permitido |
Mecanismo (mspring-parámetros-y-mapeo.md, mspring-css-linear-y-tokens.md)
| Situación | Usar |
|---|---|
| Color, opacidad, cambio de estado | Transición CSS, linear o ease-out |
| Elemento conmutado que puede invertirse a medio camino | Transición CSS (nunca keyframes) |
| Movimiento espacial de reposo a reposo con sensación de muelle | Token CSS spring linear() más su propia duración |
| Liberación después de arrastre o lanzamiento, o redireccionamiento con velocidad | Muelle JS (Motion, React Spring, SwiftUI, Compose) |
| Cambio de diseño (reordenar, redimensionar, expandir) | FLIP, Motion layout o una View Transition |
| Cambio de página o ruta | View Transition (mismo o entre documentos) |
| Progreso a través de un scroll | Animación basada en scroll |
Duración y easing por elemento (mfound-duraciones-y-easing.md)
| Elemento | Duración | Curva |
|---|---|---|
| Pulsación, conmutación, hover | 100 ms | ease-out (escala de pulsación 0,97) |
| Tooltip, menú, popover | 150 ms entrada / 110 ms salida | ease-out entrada, ease-in o fundido salida |
| Diálogo, toast | 240 ms entrada / 180 ms salida | ease-out entrada, ease-in o fundido salida |
| Panel, cajón | 240–400 ms | --motion-ease-drawer o un muelle después de arrastre |
| Transformación de contenedor (tarjeta → detalle) | 400 ms | enfatizado |
| Fundido cruzado de ruta | 150–250 ms | lineal |
Preajustes de muelles (mspring-parámetros-y-mapeo.md)
| Token | Duración / rebote | Usar |
|---|---|---|
spring-fast | 0,24 s / 0 | Conmutadores, controles pequeños |
spring-default | 0,3 s / 0 | Menús, asentamiento de panel, diseño |
spring-slow | 0,45 s / 0 | Superficies de pantalla completa |
spring-snappy | 0,3 s / 0,15 | Liberación después de un golpe, snaps |
spring-playful | 0,4 s / 0,3 | Solo deleite raro |
Los parámetros de las bibliotecas (Motion, React Spring, SwiftUI, Material 3) provienen de una fórmula en mspring-parámetros-y-mapeo.md.
Umbrales de gestos (mgesture-*)
| Valor | Predeterminado |
|---|---|
| Inicio de arrastre / bloqueo de eje | 10 px |
| Ventana de muestreo de velocidad | 100 ms |
| Desaceleración de proyección | 0,998 por ms (0,99 para paginación rápida) |
| Golpe confirmado | > 400 px/s |
| Cierre de panel | > 25% de su altura arrastrada, o un golpe |
| Constante de banda elástica | 0,55 (la aproximación común) |
Valores predeterminados de tokens
Conjunto completo en assets/motion-tokens.css.
| Grupo | Predeterminados |
|---|---|
| Duración | instant 0 · micro 100 · short 150 · medium 240 · long 400 ms · relación de salida 0,75 |
| Easing | estándar cubic-bezier(0.2,0,0.38,0.9) · entrada (0,0,0.38,0.9) · salida (0.2,0,1,0.9) · enfatizado (0.2,0,0,1) · cajón (0.32,0.72,0,1) |
| Muelles (CSS) | --motion-spring-{fast,default,slow,snappy,playful} con -dur correspondiente (360 / 450 / 670 / 420 / 660 ms) |
| Geometría | escala desde 0,96 · pulsación 0,97 · distancia 8 / 16 / 24 px |
| Coreografía | retardo 30 ms · máximo 300 ms (150 ms en menús) |
| Movimiento reducido | los tokens espaciales se colapsan a 0 o 1; los fundidos mantienen su temporización |
Cómo aplicar esta habilidad
- Al construir:
- Carga
assets/motion-tokens.csso mapéalo a los tokens del proyecto. - Prefiere las funciones de la plataforma: transiciones CSS,
@starting-style,<dialog>y la API popover, View Transitions, animaciones basadas en scroll,linear(). Recurre a una biblioteca JS solo para gestos y velocidad. - Nunca uses el tipo
anyde TypeScript.
- Carga
- Al revisar: captura los frames primero, luego ejecuta la galería de antipatrones y la rúbrica. Informa una tabla de comprobación, puntuación, evidencia y corrección, ordenada por gravedad, y enumera lo que no comprobaste.
- Cuando el proyecto tiene un sistema de movimiento (M3, Carbon, sus propios tokens): sus tokens ganan. Mapéalos a estos roles y señala las brechas.
- Cuando las reglas entren en conflicto: la accesibilidad y el control del usuario (movimiento reducido, interrumpibilidad, sin secuestro de scroll) vencen a la expresividad, y la frecuencia vence al deleite.