Skill de Animación y Movimiento
Este skill cubre animaciones y transiciones CSS con un enfoque en accesibilidad (respetando las preferencias de movimiento del usuario) y rendimiento (evitando jank y layout thrashing).
Relacionado: Para patrones interactivos solo con CSS (pestañas, acordeones, alternadores sin JavaScript), consulta el skill
progressive-enhancement.
Filosofía
El movimiento debe ser:
- Intencionado - Guía la atención, muestra relaciones, proporciona retroalimentación
- Respetuoso - Honra las preferencias de
prefers-reduced-motion - Eficiente - Usa propiedades solo del compositor cuando sea posible
- Sutil - Mejora, no distrae ni abruma
Movimiento Reducido Primero
Siempre empieza con movimiento reducido como predeterminado, luego agrega movimiento para usuarios que no hayan optado por no tenerlo.
El Patrón
/* Base: sin movimiento (predeterminado de movimiento reducido) */
.element {
transition: none;
}
/* Agrega movimiento solo cuando el usuario no ha solicitado movimiento reducido */
@media (prefers-reduced-motion: no-preference) {
.element {
transition: transform 0.3s ease, opacity 0.3s ease;
}
}
¿Por Qué Movimiento Reducido Primero?
| Enfoque | Problema |
|---|---|
| Movimiento primero, luego eliminar | Los usuarios ven un destello de movimiento antes de que se aplique la media query |
| Reducido primero, luego agregar | Predeterminado seguro, el movimiento es una mejora progresiva |
Respetando las Preferencias del Usuario
La Media Query prefers-reduced-motion
/* El usuario prefiere movimiento reducido */
@media (prefers-reduced-motion: reduce) {
* {
animation-duration: 0.01ms !important;
animation-iteration-count: 1 !important;
transition-duration: 0.01ms !important;
}
}
Movimiento Reducido Granular
En lugar de eliminar todo el movimiento, proporciona alternativas:
/* Animación completa para usuarios sin preferencia */
@media (prefers-reduced-motion: no-preference) {
.card {
transition: transform 0.3s ease, box-shadow 0.3s ease;
}
.card:hover {
transform: translateY(-4px);
box-shadow: var(--shadow-lg);
}
}
/* Alternativa sutil para movimiento reducido */
@media (prefers-reduced-motion: reduce) {
.card {
transition: box-shadow 0.15s ease;
}
.card:hover {
box-shadow: var(--shadow-md);
}
}
Detección con JavaScript
const prefersReducedMotion = window.matchMedia(
'(prefers-reduced-motion: reduce)'
).matches;
if (prefersReducedMotion) {
// Usa transiciones instantáneas o salta animaciones
element.style.transition = 'none';
} else {
// Animación completa
element.animate(keyframes, options);
}
Propiedades Seguras para el Rendimiento
Propiedades Solo del Compositor (Rápidas)
Estas propiedades se pueden animar sin activar layout o paint:
| Propiedad | Uso |
|---|---|
transform | Movimiento, escalado, rotación |
opacity | Fundido de entrada/salida |
filter | Desenfoque, brillo (acelerado por GPU) |
/* BUENO: Solo compositor */
.card:hover {
transform: translateY(-4px) scale(1.02);
opacity: 0.9;
}
Propiedades a Evitar Animar
Estas activan costosos recálculos de layout:
| Propiedad | Problema |
|---|---|
width, height | Recalculo de layout |
top, left, right, bottom | Recalculo de layout |
margin, padding | Recalculo de layout |
border-width | Recalculo de layout |
font-size | Layout + reflujo de texto |
/* MALO: Activa layout */
.card:hover {
margin-top: -4px; /* Layout thrashing */
height: 110%; /* Layout thrashing */
}
/* BUENO: Usa transform en su lugar */
.card:hover {
transform: translateY(-4px) scaleY(1.1);
}
Promover a Capa de Compositor
Usa will-change con moderación para animaciones conocidas:
/* Úsalo solo para elementos que SÍ van a animar */
.animated-element {
will-change: transform, opacity;
}
/* Elimínalo después de que la animación termine */
.animated-element.animation-done {
will-change: auto;
}
Advertencia: No apliques will-change a muchos elementos: consume memoria.
Patrones de Transición
Integración con Tokens de Diseño
:root {
/* Escala de duración */
--duration-instant: 0.1s;
--duration-fast: 0.15s;
--duration-normal: 0.3s;
--duration-slow: 0.5s;
/* Funciones de easing */
--ease-out: cubic-bezier(0, 0, 0.2, 1);
--ease-in: cubic-bezier(0.4, 0, 1, 1);
--ease-in-out: cubic-bezier(0.4, 0, 0.2, 1);
--ease-bounce: cubic-bezier(0.68, -0.55, 0.265, 1.55);
}
Transiciones Comunes
/* Efecto de elevación al hacer hover */
@media (prefers-reduced-motion: no-preference) {
.card {
transition:
transform var(--duration-fast) var(--ease-out),
box-shadow var(--duration-fast) var(--ease-out);
}
.card:hover {
transform: translateY(-2px);
box-shadow: var(--shadow-md);
}
}
/* Anillo de enfoque */
@media (prefers-reduced-motion: no-preference) {
button {
transition: outline-offset var(--duration-instant) var(--ease-out);
}
button:focus-visible {
outline: 2px solid var(--focus-color);
outline-offset: 2px;
}
}
/* Fundido de entrada */
@media (prefers-reduced-motion: no-preference) {
.fade-in {
animation: fadeIn var(--duration-normal) var(--ease-out);
}
}
@keyframes fadeIn {
from { opacity: 0; }
to { opacity: 1; }
}
Patrones de Animación
Animaciones con Keyframes
/* Pulso sutil para llamar la atención */
@keyframes pulse {
0%, 100% { transform: scale(1); }
50% { transform: scale(1.05); }
}
@media (prefers-reduced-motion: no-preference) {
.notification-badge {
animation: pulse 2s var(--ease-in-out) infinite;
}
}
/* Alternativa de movimiento reducido: sin animación */
@media (prefers-reduced-motion: reduce) {
.notification-badge {
animation: none;
}
}
Spinners de Carga
/* Spinner que respeta el movimiento reducido */
@keyframes spin {
to { transform: rotate(360deg); }
}
.spinner {
width: 24px;
height: 24px;
border: 2px solid var(--border-color);
border-top-color: var(--primary-color);
border-radius: 50%;
}
@media (prefers-reduced-motion: no-preference) {
.spinner {
animation: spin 1s linear infinite;
}
}
@media (prefers-reduced-motion: reduce) {
.spinner {
/* Indicador estático u opacidad pulsante */
animation: none;
border-style: dotted;
}
}
Carga con Esqueleto
@keyframes shimmer {
0% { background-position: -200% 0; }
100% { background-position: 200% 0; }
}
.skeleton {
background: linear-gradient(
90deg,
var(--surface-color) 25%,
var(--background-alt) 50%,
var(--surface-color) 75%
);
background-size: 200% 100%;
}
@media (prefers-reduced-motion: no-preference) {
.skeleton {
animation: shimmer 1.5s infinite;
}
}
@media (prefers-reduced-motion: reduce) {
.skeleton {
animation: none;
background: var(--background-alt);
}
}
Animaciones de Entrada
Fundido y Deslizamiento
@keyframes fadeSlideUp {
from {
opacity: 0;
transform: translateY(10px);
}
to {
opacity: 1;
transform: translateY(0);
}
}
@media (prefers-reduced-motion: no-preference) {
.animate-in {
animation: fadeSlideUp var(--duration-normal) var(--ease-out) both;
}
/* Hijos escalonados */
.animate-in > * {
animation: fadeSlideUp var(--duration-normal) var(--ease-out) both;
}
.animate-in > *:nth-child(1) { animation-delay: 0ms; }
.animate-in > *:nth-child(2) { animation-delay: 50ms; }
.animate-in > *:nth-child(3) { animation-delay: 100ms; }
.animate-in > *:nth-child(4) { animation-delay: 150ms; }
}
@media (prefers-reduced-motion: reduce) {
.animate-in,
.animate-in > * {
animation: none;
opacity: 1;
transform: none;
}
}
Escalado de Entrada
@keyframes scaleIn {
from {
opacity: 0;
transform: scale(0.9);
}
to {
opacity: 1;
transform: scale(1);
}
}
@media (prefers-reduced-motion: no-preference) {
dialog[open] {
animation: scaleIn var(--duration-fast) var(--ease-out);
}
}
API de View Transitions
Para transiciones de página (mejora progresiva):
/* Habilitar view transitions */
@view-transition {
navigation: auto;
}
/* Fundido cruzado predeterminado */
::view-transition-old(root),
::view-transition-new(root) {
animation-duration: var(--duration-normal);
}
/* Respetar movimiento reducido */
@media (prefers-reduced-motion: reduce) {
::view-transition-old(root),
::view-transition-new(root) {
animation-duration: 0.01ms;
}
}
/* Transiciones nombradas para elementos específicos */
.hero-image {
view-transition-name: hero;
}
::view-transition-old(hero),
::view-transition-new(hero) {
animation-duration: var(--duration-slow);
}
Animaciones Basadas en Desplazamiento
Animaciones CSS modernas basadas en desplazamiento (mejora progresiva):
/* Fundido de entrada al desplazarse */
@keyframes fadeInOnScroll {
from { opacity: 0; transform: translateY(20px); }
to { opacity: 1; transform: translateY(0); }
}
@media (prefers-reduced-motion: no-preference) {
.scroll-reveal {
animation: fadeInOnScroll linear both;
animation-timeline: view();
animation-range: entry 0% entry 100%;
}
}
@media (prefers-reduced-motion: reduce) {
.scroll-reveal {
opacity: 1;
transform: none;
}
}
Micro-interacciones
Presión de Botón
@media (prefers-reduced-motion: no-preference) {
button {
transition: transform var(--duration-instant) var(--ease-out);
}
button:active {
transform: scale(0.98);
}
}
Interruptor de Alternancia
.toggle-track {
width: 44px;
height: 24px;
background: var(--surface-color);
border-radius: 12px;
}
.toggle-thumb {
width: 20px;
height: 20px;
background: white;
border-radius: 50%;
transform: translateX(2px);
}
@media (prefers-reduced-motion: no-preference) {
.toggle-thumb {
transition: transform var(--duration-fast) var(--ease-out);
}
}
.toggle-input:checked + .toggle-track .toggle-thumb {
transform: translateX(22px);
}
Marca de Casilla de Verificación
.checkbox-icon {
stroke-dasharray: 24;
stroke-dashoffset: 24;
}
@media (prefers-reduced-motion: no-preference) {
.checkbox-icon {
transition: stroke-dashoffset var(--duration-fast) var(--ease-out);
}
}
.checkbox-input:checked + .checkbox-box .checkbox-icon {
stroke-dashoffset: 0;
}
Guías de Duración de Animación
| Tipo de Animación | Duración | Razón |
|---|---|---|
| Micro-interacción | 100-150ms | Retroalimentación inmediata |
| Transición simple | 150-300ms | Notable pero rápida |
| Animación compleja | 300-500ms | Tiempo para seguir |
| Transición de página | 300-500ms | Cambio de contexto |
| Indicador de carga | 1000-2000ms | Un ciclo visible |
La Regla de los 100ms
Los usuarios perciben las acciones como instantáneas si la respuesta es inferior a 100ms. Úsala para:
- Estados activos de botones
- Indicadores de enfoque
- Interruptores de alternancia
Patrones Peligrosos a Evitar
Desencadenantes Vestibulares
Estos pueden causar mareos por movimiento o convulsiones:
| Patrón | Problema | Alternativa |
|---|---|---|
| Desplazamiento parallax | Problemas vestibulares | Parallax estático o sutil |
| Video con reproducción automática | Movimiento inesperado | Reproducir al interactuar |
| Parpadeo (>3Hz) | Riesgo de convulsiones | Sin parpadeo |
| Zoom grande | Problemas vestibulares | Transiciones de fundido |
| Giro/rotación | Desorientación | Fundido o deslizamiento |
/* MALO: Parallax agresivo */
.parallax {
transform: translateY(calc(var(--scroll) * 0.5));
}
/* MEJOR: Sutil o desactivado con movimiento reducido */
@media (prefers-reduced-motion: reduce) {
.parallax {
transform: none;
}
}
Animaciones Infinitas
/* MALO: Movimiento constante */
.attention-seeker {
animation: bounce 1s infinite;
}
/* MEJOR: Iteraciones limitadas */
.attention-seeker {
animation: bounce 1s 3; /* Solo 3 veces */
}
/* MEJOR: Activar al interactuar */
.attention-seeker:hover {
animation: bounce 0.5s;
}
Lista de Verificación para Pruebas
DevTools del Navegador
- Chrome: Rendering > Emulate CSS media feature > prefers-reduced-motion: reduce
- Firefox: about:config > ui.prefersReducedMotion (0=no-preference, 1=reduce)
- Safari: Develop > Experimental Features > Reduced Motion
Configuración del Sistema
- macOS: Preferencias del Sistema > Accesibilidad > Pantalla > Reducir movimiento
- iOS: Configuración > Accesibilidad > Movimiento > Reducir Movimiento
- Windows: Configuración > Acceso Fácil > Pantalla > Mostrar animaciones
- Android: Configuración > Accesibilidad > Eliminar animaciones
Lista de Verificación
Al agregar animaciones o transiciones:
- Se respeta
prefers-reduced-motion - El movimiento reducido tiene una alternativa significativa (no solo desactivado)
- Solo se animan propiedades del compositor (
transform,opacity) -
will-changese usa con moderación y se elimina después de la animación - Los tokens de duración se usan de manera consistente
- No hay contenido parpadeante (>3 parpadeos por segundo)
- Las animaciones infinitas tienen un propósito y se pueden detener
- Parallax y movimientos grandes son mejoras opcionales
- Los estados de carga funcionan sin animación
- La animación mejora en lugar de distraer
Skills Relacionados
- css-author - Organización moderna de CSS con @import nativo, @layer en cascada...
- progressive-enhancement - Desarrollo primero en HTML con patrones interactivos solo con CSS
- performance - Escribe páginas HTML amigables con el rendimiento
- accessibility-checker - Asegura el cumplimiento de WCAG2AA