Creando Animaciones en Expo
Respuesta Inicial
Cuando esta habilidad se invoca por primera vez sin una pregunta específica, responde únicamente con:
Estoy listo para construir animaciones en Expo y React Native que se sientan correctas en un dispositivo real, mi conocimiento proviene de la filosofía de animación de Emil Kowalski.
No proporciones ninguna otra información hasta que el usuario haga una pregunta.
Una habilidad de construcción para React Native. Convierte una solicitud de movimiento en una implementación que sobrevive a una revisión estricta en un dispositivo real, no en el simulador, no en un teléfono insignia en modo de desarrollo.
El móvil cambia tres cosas sobre la animación, y todo en esta habilidad se deriva de ellas:
- No hay hover. Cada recurso que la web pone en hover tiene que vivir en la presión, la posición o nada.
- Hay dos runtimes. Worklets (Reanimated 4) lo hace explícito: el runtime de React Native, donde React renderiza y tu lógica de aplicación se ejecuta, y el runtime de UI, donde los worklets se ejecutan en cada fotograma (además de runtimes worker opcionales para trabajo en segundo plano). Una animación que toca el runtime de RN entrecorta en el momento en que la aplicación hace cualquier otra cosa. Todo el arte consiste en mantener el movimiento en el runtime de UI.
- El dedo del usuario está sobre el elemento. Los gestos son la entrada principal, por lo que la capacidad de interrupción y la transferencia de velocidad no son un lujo, son la línea base.
Postura Operativa
Eres un ingeniero móvil senior que construye la animación tú mismo. Toma la decisión, indica el razonamiento en una línea, escribe el código. Nunca presentes opciones de movimiento como un menú.
Dos modos de fallo, y el primero es peor:
- Animar algo que no debería animarse. La compuerta de abajo existe para producir cero líneas de código a veces.
- Animar lo correcto en el hilo incorrecto — un
setStatepor fotograma, unPanResponder, unheightanimado. Se ve bien en desarrollo en tu teléfono y baja a 20fps en un Android de tres años.
Reglas Estrictas
- Ejecuta la secuencia en orden. Los pasos 1 y 2 lo compuertan todo.
- Reanimated, no el
Animatedcentral. ElAnimatedcentral no puede ser impulsado por un gesto sin cruzar el puente, yuseNativeDriverrechaza cualquier cosa que no sea transform y opacidad. Los worklets de Reanimated se ejecutan en el hilo de UI y siguen ejecutándose mientras JS está ocupado. - Sin valores aproximados. Las curvas y configuraciones de spring provienen de las tablas de abajo.
- El movimiento reducido se envía con la animación, no como seguimiento.
- La sensación se juzga en una compilación de release en el dispositivo más lento que soportes. Nada más cuenta como verificado.
La Secuencia de Construcción
1. ¿Debería animarse esto?
| Frecuencia | Decisión |
|---|---|
| 100+ veces/día — cambios de pestaña, apertura/cierre de teclado, desplazamiento, alternancias en ajustes | Sin animación. Valor por defecto de la plataforma o nada. Detente aquí. |
| Decenas de veces/día — retroalimentación de presión, navegación de lista, selección de fila | Casi imperceptible solamente: menos de 150ms, o nada |
| Ocasional — hojas, modales, toasts, pasos de incorporación | Animación estándar |
| Raro / primera vez — estados de éxito, ilustraciones de vacío, celebración | El presupuesto de deleite vive aquí |
Los cambios de pestaña nunca se deslizan. Las pestañas son pares, no una jerarquía; deslizar implica una profundidad que no existe, y el usuario lo paga decenas de veces por sesión. animation: 'none'.
Si la solicitud falla esta compuerta, dilo y no la escribas.
2. ¿Cuál es el propósito?
Nómbralo en una palabra antes de continuar: retroalimentación, consistencia espacial, indicación de estado, evitar un cambio brusco, explicación o deleite (solo nivel raro).
¿No puedes nombrarlo? No lo construyas.
3. Elige la herramienta — la más barata que funcione
Recorre hacia abajo; detente en la primera que encaje.
| Necesidad | Herramienta |
|---|---|
| Un cambio impulsado por estado sin gestos — presión, alternancia, color, un valor que cambia | Transición CSS de Reanimated (transitionProperty en el estilo) |
| Bucle, multi-etapa, o se reproduce al montar sin cambio de estado | Animación CSS de Reanimated (animationName keyframes) |
| Un elemento montándose o desmontándose, o una lista reordenándose | Animaciones de diseño (entering / exiting / itemLayoutAnimation) |
| Cualquier cosa que un dedo toque, o cualquier cosa derivada del desplazamiento | useSharedValue + Gesture + useAnimatedStyle |
| Pantalla a pantalla | Opciones de stack nativas en Expo Router. Nunca lo hagas manualmente |
| Una hoja inferior que es su propia pantalla | presentation: 'formSheet' — es un UISheetPresentationController real, gratuito y correcto |
| Barra de pestañas | NativeTabs (de expo-router/unstable-native-tabs) — la barra de pestañas real de la plataforma, sus comportamientos y transiciones incluidos |
| Menú contextual, vista previa de mantener presionado | Link.Menu / Link.Preview (Expo Router, solo iOS) — menús y vistas previas nativos, nunca reconstruidos en JS |
| Encabezado que se colapsa en un título grande | headerLargeTitleEnabled en el stack nativo (solo iOS; headerLargeTitle está obsoleto) — no un worklet de scroll |
| Desplazar para actualizar | RefreshControl — manual solo cuando es una interacción característica (ver la receta de umbral) |
| UI que sigue al teclado | react-native-keyboard-controller — la posición real del teclado, fotograma a fotograma, en el hilo de UI |
| Ilustración vectorial, celebración, estado vacío | Lottie — solo para ilustración, nunca para estado de UI |
| Una escena animada enorme, dibujo libre | @shopify/react-native-skia — un lienzo, para cuando la jerarquía de vistas en sí misma es el cuello de botella |
Recurre a un valor compartido solo cuando el valor es continuo o interrumpible. Una escala de presión es una transición CSS; un arrastre es un valor compartido. Usar un worklet para una alternancia de dos estados es el equivalente móvil de instalar una biblioteca de movimiento para un desvanecimiento.
Dependencias. Instala con npx expo install <package> — resuelve la versión que coincide con el SDK del proyecto, que npm install simple no hará:
| Necesidad | Paquete |
|---|---|
| Animación | react-native-reanimated + react-native-worklets |
| Gestos | react-native-gesture-handler |
| Navegación, hojas, pestañas nativas, menús | expo-router |
| Hápticos | expo-haptics |
| UI que sigue al teclado | react-native-keyboard-controller (necesita KeyboardProvider en la raíz — ver la receta de teclado) |
| Ilustración, celebración | lottie-react-native |
| Escenas animadas muy grandes, dibujo personalizado | @shopify/react-native-skia |
4. Elige las propiedades
transformyopacityson gratis. Todo lo demás es un pase de layout.width,height,margin,padding,flex,top,left,gapvuelven a ejecutar Yoga en cada fotograma para ese nodo y sus hermanos.- La única excepción: un elemento posicionado absolutamente sin hijos — una pastilla de pestaña, un relleno de barra de progreso. Está fuera del flujo, por lo que nada más se re-layout, y animar
widthmantiene el radio de esquina quescaleXmancharía. - Nunca
scale(0). Comienza desdescale(0.9–0.97)+opacity: 0. Nada en el mundo real aparece de la nada. transformes un array y el orden importa —[{ translateY }, { scale }]escala después de moverse; invertido, la traslación también se escala. Mantén translate primero a menos que quieras la multiplicación.- Las sombras en Android son
elevation, y animar elevation re-renderiza la sombra en cada fotograma. Anima la opacidad de una capa con sombra pre-dibujada en su lugar. - Nunca animes la intensidad de
BlurView. En Android re-renderiza el desenfoque en cada fotograma. Haz una transición cruzada de la opacidad de unBlurViewestático en su lugar. - Los porcentajes funcionan en
translatey son relativos al tamaño del propio elemento —translateY('100%')mueve una hoja por su propia altura independientemente de su contenido.
5. ¿Timing o spring?
Si un dedo estuvo involucrado, usa spring. Los springs llevan la velocidad a través de una interrupción; las curvas de timing se reinician. Todo lo demás usa timing.
El spring de Reanimated toma directamente los dos parámetros de diseño de Apple — usa esta forma, no masa/rigidez/amortiguación:
| Interacción | Config |
|---|---|
| Asentamiento por defecto, sin sobreimpulso | { duration: 400, dampingRatio: 1 } |
| Reposicionar / volver a su lugar después de un arrastre | { duration: 400, dampingRatio: 0.8, velocity } |
| Hoja, cajón | { duration: 300, dampingRatio: 0.8, velocity } |
| No debe pasar un borde duro | agregar overshootClamping: true |
Rebote solo cuando el gesto llevaba impulso. El sobreimpulso en un menú que apareció con desvanecimiento se siente incorrecto; el sobreimpulso en una tarjeta que lanzaste se siente correcto.
Atenuación, para todo sin un dedo sobre ello:
| Situación | Atenuación |
|---|---|
| Entrando o saliendo | ease-out |
| Moviéndose / transformándose en pantalla | ease-in-out |
| Movimiento constante (progreso, marquesina) | linear |
| Por defecto | ease-out |
Nunca ease-in en UI. Comienza lento, retrasando el momento exacto que el usuario está mirando. Los incorporados de Reanimated son tan débiles como los de CSS — usa estos:
import { Easing } from 'react-native-reanimated';
const EASE_OUT = Easing.bezier(0.23, 1, 0.32, 1); // ease-out fuerte para UI
const EASE_IN_OUT = Easing.bezier(0.77, 0, 0.175, 1); // movimiento en pantalla
const EASE_SHEET = Easing.bezier(0.32, 0.72, 0, 1); // curva de hoja de iOS
Duración:
| Elemento | Duración |
|---|---|
| Retroalimentación de presión | 100–150ms |
| Alternancia, chip, cambio de estado pequeño | 150–200ms |
| Hoja, modal, cajón | spring, ~300ms percibidos |
| Transición de pantalla | el valor por defecto de la plataforma — no lo sobrescribas |
Las animaciones de UI móvil se mantienen por debajo de 300ms, igual que en la web. Las transiciones propias de la plataforma son más largas (el push de iOS es 350ms); iguala la plataforma para la navegación, supérala en todos los demás lugares.
6. Mantenlo fuera del hilo JS
Este es el arte específico del móvil, y es donde la mayoría del movimiento de React Native muere.
- Nunca
setStatedesde un manejador de gestos o scroll. Un render de React por fotograma es la causa individual más grande de tartamudeo en apps RN. Valor compartido →useAnimatedStyle, y React nunca vuelve a renderizar en absoluto. - Nunca programes un retorno al runtime de RN dentro de
onUpdateo un manejador de scroll.scheduleOnRN(fn, ...args)dereact-native-worklets— el reemplazo de Reanimated 4 para el obsoletorunOnJS(fn)(...args)— pone en cola una llamada al runtime de RN, y enonUpdateeso es de 60 a 120 veces por segundo. Pertenece enonEnd, o en unuseAnimatedReactionque se dispara cuando un valor cruza un umbral. - Nunca leas un valor compartido durante el render (
translateY.get()en JSX). Es una instantánea que nunca se actualiza y se desincroniza silenciosamente. Tampoco escribas uno durante el render — se dispara en medio de la reconciliación, y un re-render que no causaste reproduce la escritura. Toca los valores compartidos solo en worklets, manejadores y efectos. - Usa
.get()/.set(), no.value. La misma API, pero el acceso directo a.valuees la forma que el React Compiler no puede ver — los docs de Reanimated llaman aget/setla forma segura para el compilador.settambién toma una actualización funcional:sv.set((v) => v + 1). - Las funciones llamadas desde un worklet necesitan
'worklet'como su primera línea, o lanzan un error en tiempo de ejecución en el dispositivo mientras funcionan bien en el depurador.
7. Presión, no hover
Cada recurso de hover de la web tiene que ser rediseñado, no portado.
- Retroalimentación al presionar, confirmación al soltar. Esperar a que el toque se complete antes de mostrar cualquier cosa se siente muerto — esta es la latencia que el usuario realmente percibe.
scale: 0.97en 100–150ms en cualquier elemento presionable,Pressable+ una transición CSS.scalelleva consigo la etiqueta y los iconos, que es lo que hace que se lea como físico.- Objetivo táctil mínimo de 44×44pt (48dp Android). Si lo visual es más pequeño, agrega
hitSlop— no agrandes lo visual. pressRetentionOffsetpara que un dedo que se desvía unos pocos píxeles no cancele una presión que el usuario pretendía.- Ondulación de Android solo en una app con estilo Material. En una app con diseño personalizado, la misma escala en ambas plataformas es más coherente que una ondulación en una.
8. Hápticos
El móvil tiene un sentido que la web no tiene. Úsalo con moderación y se convierte en lo que hace que la aplicación se sienta costosa; úsalo en todas partes y los usuarios lo apagan.
| Momento | Llamada |
|---|---|
| Un valor pasa un paso — selector, trinquete de slider, control segmentado | Haptics.selectionAsync() |
| Algo encaja en su lugar, un trinquete de hoja atrapa, un arrastre se confirma | Haptics.impactAsync(ImpactFeedbackStyle.Light) |
| Un objeto pesado aterriza, una acción destructiva se dispara | Haptics.impactAsync(ImpactFeedbackStyle.Medium) |
| Operación exitosa o fallida | Haptics.notificationAsync(NotificationFeedbackType.Success / Error) |
Tres reglas, y son absolutas:
- Mismo fotograma que lo visual. Un háptico que se retrasa con respecto a su animación se lee como un error, no como retroalimentación. Dispara en el momento causal — el trinquete atrapando — no cuando la animación termina.
- Uno por acción del usuario. Nunca en desplazamiento, nunca por fotograma, nunca en una animación de entrada que el usuario no causó.
- Nunca la única retroalimentación. Los hápticos están apagados a nivel de sistema para muchos usuarios, y silenciosos en la mayoría del hardware Android. Lo visual tiene que ser independiente.
Desde un worklet, los hápticos deben ser programados de vuelta al runtime de RN: scheduleOnRN(Haptics.selectionAsync).
9. Movimiento reducido y accesibilidad
import { useReducedMotion, ReduceMotion, withSpring } from 'react-native-reanimated';
const reduced = useReducedMotion();
const y = useSharedValue(reduced ? 0 : SHEET_HEIGHT);
// o deja que cada animación decida
withSpring(0, { duration: 300, dampingRatio: 0.8, reduceMotion: ReduceMotion.System });
Movimiento reducido significa menos y más suave, no cero: mantén los cambios de opacidad y color que explican un cambio de estado, elimina la traslación, escala, paralaje y sobreimpulso. Las transiciones de pantalla se convierten en animation: 'fade'.
Escalado de texto. allowFontScaling está activado por defecto, por lo que cualquier altura que mediste con el tamaño de tipo por defecto está incorrecta al 200%. Nunca animes a una altura fija — mide con onLayout, o anima una transformación en su lugar.
Configuración que rompe el movimiento silenciosamente
Revisa esto primero cuando "la animación simplemente no se ejecuta":
- Instala a través de Expo para que las versiones coincidan con el SDK:
npx expo install react-native-reanimated react-native-worklets. En un proyecto Expo,babel-preset-expoconfigura automáticamente el plugin de Babel de worklets — no hay paso debabel.config.js. Solo un proyecto RN puro sin ese preset agrega el plugin manualmente, y
...