Clase 04 · Módulo 06
Componentes interactivos con Motion
Componentes interactivos con Motion
Qué logras en esta clase
Agregas un componente animado con Motion dentro de tu sitio Astro y sabes si vale lo que pesa.
- Distingues cuándo Motion es la herramienta correcta.
- Lees las propiedades con que se describe una animación.
- Eliges cómo y cuándo se carga el componente.
- Mides el JavaScript que sumaste.
02
Para qué sirve Motion
Motion sirve cuando la animación depende del estado de un componente: abierto o cerrado, seleccionado, presente o eliminado.
03
Qué es Motion
- Una biblioteca de animación para React, la herramienta para construir componentes interactivos que viste en el módulo 5.
- Es la que antes se llamaba Framer Motion.
- Se instala como el paquete
motion. - Su licencia es MIT: código abierto, uso comercial permitido.
A diferencia de GSAP, aquí no escribes instrucciones de animación. Describes cómo debe verse el componente en cada estado.
04
Lo que implica en Astro
Motion vive dentro de una isla: un componente interactivo en medio de una página fija (módulo 5, clase 3). Esa isla envía al navegador el código de React, el de Motion y el del componente.
05
Cuándo sí y cuándo no
| Necesidad | Herramienta |
|---|---|
| Botón que reacciona al cursor | CSS |
| Sección que aparece al hacer scroll | CSS o GSAP |
| Relato ligado al scroll | GSAP |
| Modal o menú que anima al cerrarse | Motion |
| Lista filtrable que se reordena | Motion |
| Carrusel con arrastre | Motion |
La señal: hay un componente React con estado y quieres animar sus cambios.
06
Instalar
- Si el proyecto aún no usa React, ejecuta
npx astro add reacty acepta los cambios que propone. - Ejecuta
npm install motion. - Pídele a Claude el componente como archivo de React dentro de
src/components. - Úsalo en una página con una directiva
client:(la eliges más adelante en esta clase).
Haz commit antes del paso 1: así puedes medir y volver atrás.
07
Un componente con Motion
import { motion } from "motion/react";
export default function BotonReserva() {
return (
<motion.button whileHover={{ scale: 1.05 }} whileTap={{ scale: 0.95 }}>
Reservar hora
</motion.button>
);
}motion.button es un botón normal con propiedades de animación. Existe lo mismo para cualquier etiqueta: motion.div, motion.li.
Este ejemplo sirve para leer la sintaxis. Un hover como este se resuelve mejor con CSS.
08
Las propiedades que describen el movimiento
| Propiedad | Qué define |
|---|---|
initial | Cómo parte al aparecer |
animate | El estado al que debe llegar |
exit | Cómo se va al ser eliminado |
whileHover, whileTap | Mientras hay cursor o presión |
whileInView | Mientras está en pantalla |
transition | Duración, curva y retraso |
09
Describes estados, no pasos
Cuando el valor de animate cambia, Motion calcula solo el camino entre el estado anterior y el nuevo. Tú no programas la secuencia.
10
Animar lo que desaparece
<AnimatePresence>
{abierto && (
<motion.div
initial={{ opacity: 0 }}
animate={{ opacity: 1 }}
exit={{ opacity: 0 }}
/>
)}
</AnimatePresence>En React, un elemento que deja de mostrarse se elimina de inmediato, sin tiempo para animar. AnimatePresence lo retiene hasta que termina su exit.
Es la razón más común para elegir Motion: modales, menús y avisos que también se van con suavidad.
11
Animar cambios de lugar y tamaño
La propiedad layout hace que un elemento se deslice hasta su nueva posición cuando la lista cambia de orden o de tamaño.
12
Cuándo se carga la isla
| Directiva | Carga el JavaScript | Para |
|---|---|---|
client:load | Al cargar la página | Menú, lo que está arriba |
client:visible | Al entrar en pantalla | Carrusel o filtro más abajo |
client:only="react" | Solo en el navegador | Lo que no puede generarse antes |
Con las dos primeras, el componente llega primero como HTML fijo y luego se activa. Prefiere client:visible siempre que la pieza no esté a la vista al entrar.
13
Sin directiva no hay animación
Es el primer punto que debes revisar cuando una isla «no hace nada». El segundo: abrir la consola del navegador y buscar errores, como viste en el módulo 5.
14
Qué puedes pasarle a una isla
Los datos que la página Astro entrega a la isla deben ser simples: textos, números, listas, objetos.
Si Claude propone una solución rebuscada para comunicar la página con la isla, suele ser señal de que el componente está mal delimitado.
15
Una isla por pieza interactiva
Envolver la página entera en una isla para animar un detalle anula la ventaja de Astro. La isla debe ser tan chica como la pieza que interactúa.
16
Respetar menos movimiento
Motion ofrece el componente MotionConfig con la opción reducedMotion:
| Valor | Efecto |
|---|---|
"user" | Sigue la preferencia del sistema |
"always" | Reduce siempre |
"never" | No reduce nunca |
Con "user", cuando el visitante pidió menos movimiento se desactivan los desplazamientos y los cambios de layout, y se conservan los de opacidad y color. Pide que cada isla venga envuelta así.
17
Medir lo que sumaste
- Antes de instalar, abre tu página en Chrome con las herramientas de desarrollo en la pestaña Network.
- Filtra por JS, recarga y anota el total transferido.
- Agrega el componente y repite la medición.
- Compara: la diferencia es el costo real de esa pieza.
18
Decidir con el número en la mano
- Motion solo incluye lo que el componente importa, y su documentación tiene una guía para reducir el peso. Pídele a Claude que la aplique si el número te parece alto.
- Si la isla es lo primero que se ve, su carga afecta la respuesta de la página (INP, módulo 9).
- Si el beneficio es solo estético, pregúntate si un cierre sin animación sería un problema para alguien.
19
Motion, GSAP o CSS
| CSS | GSAP | Motion | |
|---|---|---|---|
| Requiere React | No | No | Sí |
| Licencia | Estándar web | Propia, sin costo | MIT |
| Mejor para | Estados simples | Scroll y secuencias | Componentes con estado |
Pueden convivir en un mismo sitio, pero cada una suma peso y una forma distinta de hacer las cosas. Para la mayoría de los sitios de contenido bastan CSS y, a lo más, una de las otras dos.
20
Cómo pedírselo a Claude
En el diff, comprueba la importación desde motion/react, la directiva client: y que no se haya convertido en isla nada más que el acordeón.
21
Lo que te llevas
- Motion es para animar cambios de estado en componentes React: entradas, salidas y reordenamientos.
- En Astro vive en una isla, y la isla trae React y Motion al navegador.
AnimatePresenceanima lo que se elimina;layout, lo que cambia de lugar.- Sin directiva
client:no hay interacción;client:visiblees la opción más liviana. - Se mide antes y después, y se decide con el número.
22
Hazlo ahora
En 15 minutos:
- Elige una sola pieza de tu web que tenga estado: menú móvil, preguntas frecuentes o un filtro.
- Mide el JavaScript de esa página en la pestaña Network.
- Pídele a Claude la pieza con Motion, con el nivel de detalle del ejemplo.
- Mide de nuevo y anota la diferencia.
- Emula
prefers-reduced-motion, prueba con teclado y decide si la dejas. Haz commit o vuelve atrás.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026
- Motion Docs: inicio rápido para Reactmotion.dev ↗
- Motion Docs: accesibilidad y movimiento reducidomotion.dev ↗
- Registro npm: paquete motion (versión y licencia)registry.npmjs.org ↗
- Astro Docs: integración de Reactdocs.astro.build ↗
- Astro Docs: componentes de frameworks y directivas clientdocs.astro.build ↗
- web.dev: Web Vitalsweb.dev ↗