Antheo Motion
El movimiento es información sobre el cambio: algo llegó, se fue, se movió o te respondió. El movimiento que no explica nada es ruido; un cambio sin movimiento es un salto. Esta habilidad decide qué cambios se mueven y le da a cada uno su tiempo exacto. El momento emblemático de un componente pertenece a antheo-moment; los tokens de duración los genera antheo-tokens; el requisito de movimiento reducido lo comprueba antheo-access. Auditar, recortar o planificar el movimiento en toda una aplicación es tarea de antheo-motion-audit.
Decide en este orden
- Enumera cada cambio que hace la pantalla: qué se abre, cierra, aparece, desaparece, reordena, actualiza, carga, tiene éxito o falla.
- Marca con qué frecuencia lo ve una persona: muchas veces al día, a diario, o raramente.
- Asigna a cada uno su duración y curva de las tablas siguientes.
- Entrega el único evento raro y significativo, si lo hay, a antheo-moment.
- Compruébalo rápido, dos veces, y con movimiento reducido, luego grábalo y lee los fotogramas (abajo).
Nombra por qué se mueve, o no lo muevas
"Esto se mueve para que la persona entienda ___." ¿No puedes terminar la frase? Sin animación.
Cuanto más se ve, menos se mueve
| Frecuencia | Recibe |
|---|---|
| Muchas veces al día (escribir, filas, pestañas, menús, una paleta) | como máximo 150ms, 4px de recorrido; desde el teclado, solo un breve fundido |
| A diario (un diálogo, una hoja, un toast, un guardado) | una breve llegada y una salida más rápida, de 150 a 300ms |
| Raramente (un primer éxito, un pedido realizado) | el único lugar para un momento emblemático (antheo-moment) |
Las duraciones, según la tarea
| Token | Valor | Se usa en |
|---|---|---|
--dur-instant | 100ms | feedback de color y opacidad |
--dur-fast | 150ms | pulsación, hover de entrada y salida, apertura de menú o tooltip |
--dur-base | 200ms | cosas que desaparecen, cierre de diálogo, intercambio de valor o texto, llegada de un toast |
--dur-open | 250ms | apertura de diálogo, pestañas, acordeón, redimensionamiento de tarjeta |
--dur-slow | 300ms | elevación de una hoja o cajón, deslizamiento de un marcador |
--dur-page | 400ms | transición de página o de elemento compartido |
El movimiento de la interfaz se mantiene en 300ms o menos; los movimientos de página en 400ms o menos. Los spinners, barras de progreso y animaciones vinculadas al scroll usan linear.
Abrir y cerrar, como pares
| Elemento | Abre | Cierra |
|---|---|---|
| Menú, popover, select | 150ms, desde scale(0.97) y fundido, en el disparador | 120ms |
| Tooltip | Retardo de 400ms, luego fundido de 150ms; inmediato si está dentro de 300ms de otro cierre | inmediato |
| Diálogo | 250ms: elevación de 8px, fundido, escala desde 0.96 | 200ms |
| Hoja, cajón | 300ms desde su borde, completamente opaco durante todo el proceso (sin fundido, sin desenfoque) | 200ms |
| Toast | 200ms, elevación de 12px | 200ms, sale por donde vino |
| Acordeón, revelación de altura | 250ms, grid-template-rows: 0fr a 1fr | 200ms |
Nunca retrases un cierre o un hover-out: acorta la duración.
Una única curva para llegar y salir
--ease-out cubic-bezier(0.23, 1, 0.32, 1) para todo lo que entra o sale. --ease-in-out cubic-bezier(0.77, 0, 0.175, 1) solo para algo que se mueve de un lugar a otro en la pantalla. --ease-in solo para algo que se descarta definitivamente. Las salidas son más rápidas que las entradas y recorren aproximadamente la mitad de distancia.
Distancias pequeñas, nunca desde cero
Recorre 4px para un intercambio de valor o un popover, 8px para un diálogo, 12px para un toast, 24px para un elemento principal; el borde completo solo para una hoja. Entra desde scale(0.96) (0.97 para menús, 0.98 para tooltips) con opacidad 0, nunca desde scale(0). Desenfoque de 4px en un intercambio de texto o icono, 8px en una superficie grande, 2px en un fundido cruzado de menos de 200ms.
Qué puede animarse
transform y opacity (y color) por defecto; un desenfoque filter corto, clip-path y grid-template-rows para revelaciones de altura cuando sea necesario. Nunca transition: all, nunca width, height, top, left o margin, nunca box-shadow en sí mismo: pon una sombra cambiante en un pseudoelemento y desvanécela. will-change solo después de que un perfil lo solicite.
Crece desde el disparador
Los menús y popovers toman su transform-origin en el disparador (Radix expone --radix-popover-content-transform-origin); un modal permanece centrado; una hoja viene desde el borde en el que vive; un elemento compartido (una tarjeta que se abre en su página) usa un view-transition-name en cada lado.
Transiciones para estado, keyframes para un solo uso
Cualquier cosa que una persona pueda alternar usa una transición CSS o un resorte, que se invierten a medio vuelo; keyframes solo para cosas que se reproducen una vez.
Escalonamiento de 30 a 40ms, los primeros ocho, 300ms en total
De 60 a 80ms para las tres a seis partes de un elemento principal. Nunca escalones algo que se abre con frecuencia, y nunca bloquees un clic mientras los elementos llegan.
Resortes solo donde una mano lo mueve
Una perilla de interruptor, un arrastre soltado, una píldora segmentada que se desliza. Rebote de 0 a 0.2 en controles (el rebasamiento se mantiene dentro de la pista), hasta 0.45 para una celebración rara; como máximo un bamboleo. Un arrastre sigue al dedo sin transición y, al soltarlo, salta desde la velocidad de liberación; una hoja se cierra con un movimiento rápido mayor a aproximadamente 0.11px por ms, o una vez que ha recorrido min(64px, 15%) de su altura; de lo contrario, vuelve a su lugar (references/gestures.md).
Nada salta
Cada valor que cambia se ve cambiar; una fila eliminada cierra su espacio; se reserva espacio para lo que aparece (desplazamiento del layout menor a 0.1). Al cargar, como máximo una entrada. Cambia de temas con las transiciones desactivadas durante un fotograma.
Movimiento reducido mantiene la historia en fundidos
Con prefers-reduced-motion: reduce, el recorrido, la escala, el desenfoque, el paralaje y los rebotes se convierten en un fundido cruzado de opacidad de 150 a 200ms; una perilla de interruptor se mueve de inmediato; los bucles de reproducción automática se detienen. Cualquier cosa que se mueva por sí sola durante más de 5 segundos tiene un control de pausa (WCAG 2.2.2); nada parpadea más de 3 veces por segundo (2.3.1).
En toda una aplicación
- Encuentra: una tabla de cada cambio, con qué frecuencia se ve, cómo se mueve ahora, cómo debería.
- Mejora: tokens para cada número, las salidas que faltan, origen en el disparador, un patrón a la vez.
- Elimina: cualquier cosa que se anime en cada carga, se reproduzca en una acción de varias veces al día, retrase la siguiente acción, haga bucles mientras la gente lee, o supere los 300ms en una acción rutinaria. Cuando tengas dudas, elimínalo.
- Aprueba o bloquea: una frase de motivo, solo tokens, solo las propiedades permitidas, una salida más rápida que la entrada, movimiento reducido manejado, visto a velocidad normal y con ralentización de CPU 4×.
Compruébalo
Haz clic en todo rápido, dos veces: se invierte, nunca salta. Abre el menú veinte veces: sigue siendo rápido. Acelera la CPU 4×: sigue siendo suave. Activa el movimiento reducido: nada viaja.
Míralo: una imagen fija no puede juzgar el movimiento
Una captura de pantalla del estado de reposo no dice nada sobre cómo se mueve algo, y cada revisor lee fotogramas fijos. Así que graba cada movimiento que hiciste y mira los fotogramas antes de darlo por terminado:
node <antheo-motion>/scripts/filmstrip.mjs <url> --clip ".tuner" --click ".preset" --duration 600
node <antheo-motion>/scripts/filmstrip.mjs <url> --clip ".sheet" --drag ".handle" --by 0,240 --duration 900
Ralentiza la página a 0.1× (CSS, Web Animations y el reloj de JavaScript), hace la única acción y coloca 12 fotogramas del elemento en una sola hoja, cada uno con su tiempo. Abre la hoja y lee cada fotograma:
- cada fotograma se ve compuesto por sí mismo: ningún borde duro deslizándose, ningún destello del color incorrecto, ninguna caja vacía
- cada valor que cambia se ve cambiar: un número que debería rodar no salta mientras su aguja aún viaja
- nada se refluye o salta a mitad de camino; el primer fotograma ya responde a la pulsación
- el final se asienta donde debe: un resorte rebasa un poco y vuelve, un control no se detiene en seco
- grábalo de nuevo con
--reducey--dark: la historia aún se cuenta, y el modo oscuro no tiene destello de luz
Arregla lo que muestra un fotograma, grábalo de nuevo y guarda la última hoja como evidencia.
Lo que la IU generada hace mal aquí
Revisa cada uno en references/habits.md antes de darlo por terminado: transition: all · contenido oculto hasta que un script lo revela · un restablecimiento general de movimiento reducido · un anillo de enfoque que se desvanece o desliza · movimiento que tiene rendimiento · efectos hover en cosas que no son clicables · una transición que lee un nombre que nadie definió.
Cuándo es correcto más movimiento
Las reglas de propósito y frecuencia deciden; los números son valores por defecto. Un juego, una herramienta creativa, un producto educativo o un momento de marca que la persona solicitó pueden moverse más y durante más tiempo. Aun así, responde inmediatamente a la entrada, nunca bloquea la siguiente acción, puede interrumpirse a mitad de camino, respeta el movimiento reducido y muestra su costo: un fotograma lento en un teléfono de gama media es un hallazgo, independientemente del estilo.
Terminado
- Cada cambio enumerado con la frecuencia con que se ve; los frecuentes apenas se mueven; las acciones de teclado no viajan
- Duraciones y curvas de aceleración de los tokens; los pares de apertura y cierre de arriba; sin cierres retrasados
- Solo las propiedades permitidas; origen en el disparador; nada desde scale(0)
- El movimiento reducido se convierte en un fundido cruzado; los bucles de más de 5s se pueden pausar
- Se hizo clic rápido dos veces, con ralentización 4× y con movimiento reducido
- Cada movimiento filmado (
scripts/filmstrip.mjs), cada fotograma leído, claro, oscuro y reducido - Verificado contra cada hábito en
references/habits.md
Archivos
scripts/filmstrip.mjs: graba un movimiento a 0.1× en una hoja de fotogramas, con el tiempo debajo de cada unoreferences/recipes.md: el índice de 36 recetas listas para copiar, un archivo cada una enreferences/recipes/, desde pulsación y popover hasta rodamientos de números y texto en streamingreferences/why.md: la razón detrás de cada regla, para cuando un valor parece arbitrario o alguien quiere romperlareferences/gestures.md: arrastre, deslizamiento, hojas, puntos de ajuste, impulso, banda elástica (sensación de teléfono: antheo-mobile)references/choreography.md: varias cosas como un solo cambio: cierre de espacios, reordenaciones, redimensionamiento de paneles, fundidos cruzadosreferences/springs.md: resortes en palabras sencillas, preajustes, un resorte JS de 30 líneas,linear()con alternativasreferences/performance.md: qué es barato de animar, 60fps en un teléfono barato, cómo perfilarreferences/advanced.md: 3D, animación impulsada por scroll, View Transitions, grabación de movimientoreferences/vocabulary.md: descripciones sencillas a nombres de patrones a recetasreferences/motion-kit.css: la copia de respaldo delmotion.cssgeneradoreferences/habits.md: lo que la IU generada hace mal aquí, cada uno con su solución