Parte 4: Animaciones y fondo¶
Esta versión pública conserva las explicaciones y omite fragmentos que reproducen o adaptan la plantilla comercial.
Esta parte reconstruye en Angular lo que Portify hace con GSAP y un <canvas>:
la coreografía de entrada y de scroll, el fondo de puntos que sigue al ratón y,
porque el movimiento continuo necesita una salida, un interruptor para apagarlo
todo. Cada módulo deja código real del repositorio y un error que costó
encontrar: la pestaña de entrada que se quedaba oculta, el scroll que no
disparaba nada en la carga inicial, el menú que seguía en el orden de
tabulación con las animaciones apagadas.
Si llegaste aquí desde un buscador. Esta página es una parte de la guía «Cómo se construye este sitio», escrita sobre el repositorio de janioisacura.com, un portfolio hecho con Angular y prerenderizado a HTML estático. Lo que enseña (GSAP con ScrollTrigger dentro de Angular, un inicializador de entorno en lugar de código en cada componente, un campo de puntos en un canvas con pantallas de alta densidad y un interruptor de movimiento que gobierna JavaScript y CSS a la vez) sirve para cualquier sitio Angular con animaciones.
Proyecto: src/app/shared/animations/, src/app/shared/services/,
src/app/shared/components/background/,
src/app/shared/components/motion-toggle/ y src/styles/_base.scss.
Sitio publicado: janioisacura.com.
Alcance: animaciones, fondo de puntos e interruptor de movimiento.
Qué vas a aprender:
- Módulo A1: La coreografía central. Todas las animaciones de Portify en un solo archivo que busca sus elementos por clase, un inicializador que las ejecuta una vez por ruta y las revierte al cambiar de página, y por qué el router no sirve para la carga inicial.
- Módulo A2: Reveals que no
se quedan ocultos. Por qué un
from()con retraso dejaba el retrato y el menú en opacidad 0, la sintaxis destartde ScrollTrigger, el foco en elementos todavía invisibles y cómo distinguir un fallo de GSAP de una ventana que no pinta. - Módulo A3: El campo de
puntos. La cuadrícula de
dots-bgen una clase, con vecinos por celdas, pantallas de alta densidad y un puntero que distingue ratón de dedo. - Módulo A4: El interruptor. Un
servicio, un atributo en
<html>y una regla de CSS para apagar GSAP, el lienzo y las transiciones juntos, y la decisión de no consultar la preferencia del sistema.
Cada módulo sigue el mismo orden: el problema que resuelve, la decisión tomada en este sitio, el procedimiento o el código completo, cómo funciona por dentro, errores comunes y preguntas de entrevista con su respuesta.
Esta página es una parte de la guía Cómo se construye este sitio.
Conviene haber leído antes la Parte 3, de donde salen
las secciones que se animan, el scroll por fragmento (Módulo S3) y el
KEEP_SCROLL del selector de idioma. La anatomía de las animaciones originales
está en Estilos y animaciones.
Módulo A1: La coreografía central y su inicializador¶
Fuente: src/app/shared/animations/choreography.ts,
src/app/shared/animations/animations.utils.ts y src/app/app.config.ts del
repositorio.
El problema que resuelve¶
Portify anima con unas cien líneas de app.js: cada gsap.from(...) busca sus
elementos por selector en la página entera y se ejecuta una vez, al cargar. En
Angular la tentación es repartirlas: una directiva o un afterNextRender en
cada componente, con su ElementRef, su DestroyRef y su gsap.context. Son
diez archivos que conocen una librería de animación, y una secuencia que en
Portify es una sola (el menú entra a los 0,5 s, el retrato a los 0,3 s, las
líneas crecen desde 0) queda dispersa y sin dueño.
Además hay tres detalles de plataforma:
- El router de Angular no emite el evento
Scrollen la navegación inicial, sólo en las siguientes. El inicializador del scroll por fragmento (Parte 3, Módulo S3) funciona con él, pero una coreografía que dependiera de ese evento no arrancaría al abrir la página. - Cambiar de fragmento (
/en#about) o de idioma no debe repetir la entrada: la página es la misma. - GSAP toca
windowy el DOM: no puede correr al prerenderizar ni en las pruebas de jsdom.
La decisión en este sitio¶
- Una función,
choreography(), con todos los tweens, que encuentra sus elementos por las clases que los componentes ya pintan. Los componentes no saben que existe GSAP. Un elemento que no está en la página actual (el hero en la página de un proyecto) simplemente se salta. - Un inicializador de entorno,
provideScrollAnimations(), registrado enapp.config.tsjunto al del scroll por fragmento. Sólo en el navegador. - El momento: tras
NavigationEndy el siguiente render (afterNextRender), no trasScroll. Una vez por ruta (la URL sin fragmento ni consulta): navegar a otra página revierte la ejecución anterior antes de empezar la nueva. gsap.contextenvuelve la ejecución: revertirlo devuelve todos los elementos a su estado de CSS y mata los ScrollTrigger.- No anima cuando la navegación lleva
KEEP_SCROLL(el cambio de idioma) ni en jsdom (sinmatchMedia). - El interruptor de animaciones (Módulo A4) apaga y enciende esta misma ejecución desde el mismo inicializador.
El código¶
src/app/shared/animations/animations.utils.ts:
src/app/shared/animations/choreography.ts:
El bloque de la galería (la tarjeta .gallery-card) llegó con la Parte 5 y repite
el mismo patrón de las tarjetas de Proyectos, con un solo elemento; se explica
en el Módulo G5.
src/app/app.config.ts:
La última línea (TitleStrategy) no es de animaciones: la estrategia escribe las
etiquetas para compartir y para buscadores al fijar el título, y se explica en la
Parte 6, en el Módulo V3 de la Parte 6.
Cómo funciona por dentro¶
provideEnvironmentInitializercorre una vez al crear el inyector de la aplicación y es el sitio de una suscripción que debe vivir lo que vive la app (el mismo patrón que el scroll por fragmento). ConisPlatformBrowserse evita en el servidor, donde ni existewindow.NavigationEndmásafterNextRender.NavigationEnddice que la ruta nueva está activada;afterNextRenderespera a que Angular la haya pintado, y sólo entonces existen los elementos que la coreografía busca. Hace falta elInjectorporque se llama fuera de un contexto de inyección.- El contador
requestdescarta un render ya programado si llega una petición más nueva (por ejemplo, apagar el interruptor justo después de navegar): sin él, dos ejecuciones podían solaparse. path, sin fragmento ni consulta.urlAfterRedirects.split(/[?#]/)[0]compara páginas, no URLs:/en#aboutdespués de/enno repite nada.gsap.context(choreography, body)ejecuta la función conbodycomo ámbito: los selectores de texto ('.hero .btn') se resuelven dentro de él y todo lo creado queda registrado en el contexto. Si la función devuelve otra función, GSAP la llama al revertir: así la coreografía limpia sus oyentes de foco (Módulo A2).gsap.config({ nullTargetWarn: false })silencia el aviso por selectores sin elementos, que aquí es lo normal (la portada y la página de un proyecto no comparten elementos).- Los ScrollTrigger viven dentro de los tweens (
scrollTrigger: {...}); GSAP los registra en el contexto y los destruye al revertir. - La traducción de Portify es casi literal, con tres diferencias. No hay
SplitType: parte el texto en letras reescribiendo el DOM, algo que choca con
la hidratación, así que el bloque del hero entra entero. Las animaciones de
secciones fuera del MVP (servicios, cifras, testimonios) no existen. Y todo
son
fromTo(Módulo A2).
Errores comunes¶
- Esperar el evento
Scrolldel router para la primera ejecución. En la carga inicial no llega: la página se abría sin una sola animación. Se vio con un registro de eventos del router. - Ejecutar en cada
NavigationEnd. Pulsar un enlace del menú (misma ruta, otro fragmento) reiniciaba el menú, el hero y todas las líneas. - No revertir al cambiar de página. Al volver a la portada, los tweens de la vez anterior seguían vivos sobre elementos nuevos.
- Importar GSAP y llamarlo en un componente que también se prerenderiza. Fallaba en el servidor.
- Un
console.logo un objeto enwindowolvidado tras depurar. El diagnóstico de este módulo expusogsapy el contexto enwindow; no llegó al repositorio.
Preguntas de entrevista (senior)¶
1. ¿Dónde pondrías el código de animación de una aplicación Angular y por qué no en cada componente?¶
Respuesta:
Depende de si las animaciones son locales o forman una secuencia. Una
animación que pertenece a un componente (un acordeón, un botón) va en el
propio componente o en una directiva. Pero una coreografía de página, donde
el orden y los retrasos de elementos de distintos componentes importan, es
una sola pieza: dispersarla en diez sitios oculta la secuencia y obliga a
cada componente a conocer la librería. Aquí vive en un archivo, se ejecuta
desde un inicializador y los componentes sólo pintan clases. El precio es un
acoplamiento por nombre de clase entre la coreografía y las plantillas; es el
mismo que tiene el app.js original, concentrado en un solo sitio.
2. ¿Por qué NavigationEnd más afterNextRender y no ngAfterViewInit ni el evento Scroll del router?¶
Respuesta:
ngAfterViewInit pertenece a un componente y no sabe de rutas: no cubre una
navegación que reutiliza el componente. El evento Scroll del router llega
después de pintar, pero no se emite en la primera navegación. NavigationEnd
es la señal de «ruta activada» en todas las navegaciones, incluida la
inicial, y afterNextRender añade la garantía de que el DOM ya está pintado.
La combinación se ejecuta en el navegador, una vez por cambio de página, y se
puede cancelar con un contador si llega otra petición antes.
3. ¿Qué aporta gsap.context frente a crear los tweens sueltos?¶
Respuesta:
Agrupa todo lo creado dentro de una función (tweens, ScrollTrigger, temporizadores) bajo un objeto que se puede revertir de una vez: los elementos vuelven a su estado original y los disparadores se destruyen. En una aplicación de una página con rutas eso es imprescindible, porque la portada se destruye y se vuelve a crear al navegar y los tweens de la vez anterior seguirían apuntando a nodos que ya no existen o duplicarían el efecto. Además limita los selectores de texto a un ámbito y, si la función devuelve otra función, la ejecuta al revertir, lo que sirve para quitar oyentes propios.
Módulo A2: Reveals que no se quedan ocultos¶
Fuente: src/app/shared/animations/choreography.ts,
src/app/shared/animations/animations.utils.ts y
src/app/shared/animations/choreography.spec.ts del repositorio.
El problema que resuelve¶
La primera versión de la coreografía, traducida de Portify con gsap.from,
dejaba la página casi vacía: el retrato del hero y los enlaces del menú
aparecían un instante y se quedaban en opacidad 0; después, las
secciones nunca se mostraban. Los elementos sin retraso (el botón, el texto
del hero) sí funcionaban. Había además tres problemas vecinos:
- Una fila de Habilidades que tenía que aparecer «antes» y un
startmal escrito que la habría dejado sin animar. - Las tarjetas de Proyectos, ocultas hasta que su disparador se activa, aceptan el foco del teclado: una persona con Tab podía llegar a un enlace invisible.
- Una ventana de Chrome en la que ningún tween avanzaba, lo que hizo dudar del código durante un buen rato.
La decisión en este sitio¶
- Todos los reveals son
fromTocon los dos extremos explícitos, y el extremo final es el que el CSS ya declara (opacity: 1,scale: 1). gsap.defaults({ lazy: false })en el inicializador.startcon la sintaxis de ScrollTrigger:'top 60%'o'top bottom+=100', nunca una mezcla inventada.- La entrada de las tarjetas termina en cuanto una recibe el foco, y la coreografía devuelve la limpieza de ese oyente.
- Antes de culpar a GSAP, medir
requestAnimationFrame.
El código¶
El problema, con el from de Portify:
y su arreglo, que es el que está en el repositorio:
El reveal de Habilidades, con el start corregido:
Las tarjetas de Proyectos, con el foco (el resto del archivo está en el Módulo A1):
La prueba que lo cubre, choreography.spec.ts:
Cómo funciona por dentro¶
- Qué hace un
from()con retraso. GSAP aplica de inmediato los valores de partida (opacity: 0) y, cuando el tween se inicializa, lee del elemento los valores finales. Si el tween tienedelayo un ScrollTrigger, se inicializa después de haber aplicado sus propios valores de partida, y lee «opacidad 0» como el destino. Resultado: anima de 0 a 0. Se vio en las propiedades internas del tween del retrato (opacitycon inicio 0 y cambio 0). Los tweens sin retraso se inicializan antes y no tienen el problema. ConfromTono se lee nada del elemento. - Por qué los valores finales en CSS. El HTML prerenderizado, sin JavaScript o con el interruptor apagado, muestra el estado final de todo. La coreografía sólo añade el camino desde un estado anterior, así que nada que falle puede dejar contenido oculto para siempre.
lazy: false. GSAP «aplaza» la escritura de valores de algunos tweens hasta el siguiente frame. Un tween que empieza y termina dentro de un único frame largo (una carga lenta, una pestaña limitada) escribía primero sus valores de partida y terminaba sin ejecutarse hasta el final. Se reprodujo con un salto artificial de 1,2 s: sinlazy: falseel elemento se quedaba en opacidad 0; con él, en 1.- La sintaxis de
start. Son dos posiciones separadas por un espacio: la primera del elemento (top,center,bottom) y la segunda de la ventana (60%,bottom,bottom+=100).'top 60%'significa «cuando el borde superior del elemento llegue al 60 % de la altura de la ventana»;'top bottom+=100', «100 píxeles antes de que entre por abajo». Una cadena como'top-bottom 95%'no existe y el disparador no se crea. Un porcentaje mayor dispara antes. - El foco y lo invisible.
opacity: 0yscale: 0no quitan un enlace del orden de tabulación. Una tarjeta ya visible en la ventana (por debajo del 60 %) recibe el foco sin que haya scroll que active el disparador, y quedaba enfocada pero invisible. El oyentefocusin(que sube desde el enlace) lleva el tween a su final conprogress(1), una sola vez ({ once: true }), y se quita al revertir. - Probar con GSAP en jsdom. ScrollTrigger lee
matchMedia, que jsdom no trae: la prueba lo sustituye por una función sin coincidencias. Sirve para comprobar el estado inicial de los reveals y el oyente de foco, no el movimiento. - La ventana que no pinta. En una ventana de Chrome tapada por otra
aplicación,
requestAnimationFramecorre a una vez por segundo: se midió con 4 frames en 3 s, también en sitios sin GSAP. GSAP tiene un suavizado de retrasos: si un frame llega con más de 500 ms de retraso, avanza su reloj sólo 33 ms. Con un frame por segundo, los tweens avanzan 0,03 s cada segundo y parecen congelados. No era un fallo del código.
Errores comunes¶
- Traducir
gsap.fromde una plantilla sin pensar en el estado inicial. Funciona en la demo porque todo arranca de golpe; falla en cuanto undelayo un disparador lo retrasa. - Escribir un
startde memoria. Si el disparador no se crea, no hay error: el elemento se queda como estaba (visible o invisible). - Ocultar con opacidad lo que se puede enfocar. El mismo problema se da con cualquier menú o tarjeta con enlaces; la salida es completar el reveal al enfocar o no ocultar lo que tiene enlaces.
- Diagnosticar animaciones en una ventana que no se pinta. Antes de leer
tweens, medir
requestAnimationFrame(la comprobación de A3 en la consola sirve) ahorra horas. - Olvidar quitar el oyente al revertir. Quedaba un
focusinapuntando a una tarjeta ya destruida.
Preguntas de entrevista (senior)¶
1. Un gsap.from con delay deja un elemento invisible. ¿Qué pasó y cómo lo arreglas?¶
Respuesta:
from aplica de inmediato los valores de partida y lee del elemento los
finales cuando el tween se inicializa. Con delay o con ScrollTrigger la
inicialización ocurre después de que ya se aplicaron los valores de partida,
así que lee «opacidad 0» como destino y anima de 0 a 0. Se arregla con
fromTo, que declara los dos extremos y no consulta el DOM. Además
conviene que el estado final coincida con el CSS: así, sin JavaScript, el
contenido sigue visible.
2. ¿Cómo se lee start: 'top 60%' en ScrollTrigger y por qué 'top-bottom 95%' no funciona?¶
Respuesta:
Son dos posiciones: la primera es un punto del elemento disparador y la
segunda, un punto de la ventana. 'top 60%' activa el efecto cuando el
borde superior del elemento alcanza el 60 % de la altura de la ventana. La
segunda posición admite porcentajes, palabras (top, center, bottom) y
desplazamientos en píxeles (bottom+=100). 'top-bottom' no es ninguna de
ellas, así que el disparador no se crea y el tween no se enlaza al scroll,
sin error visible.
3. Un contenido oculto con opacidad 0 contiene un enlace. ¿Qué problema de accesibilidad hay y cómo lo resuelves?¶
Respuesta:
La opacidad no saca el enlace del orden de tabulación ni del árbol de
accesibilidad: una persona con teclado puede enfocar algo que no ve, y un
lector de pantalla lo anuncia. Si el elemento ya está en pantalla, el foco
no produce scroll y el disparador no se activa. Hay tres salidas: completar
el reveal cuando el elemento recibe el foco (la elegida), no ocultar los
elementos con enlaces, o ocultarlos con visibility: hidden y mostrarlos al
disparar, lo que los quita del orden de tabulación mientras esperan.
Módulo A3: El campo de puntos en un canvas¶
Fuente: src/app/shared/animations/dots.ts,
src/app/shared/components/background/ y
src/app/shared/animations/dots.spec.ts del repositorio.
El problema que resuelve¶
La variante dots-bg de Portify dibuja un campo de puntos: una cuadrícula
cada 45 px en la que cada punto deriva alrededor de su origen, se une con sus
cinco vecinos más cercanos y se ilumina según su distancia al ratón. El código
original son variables globales y funciones sueltas, y tiene cuatro problemas
para un sitio real:
- Para cada punto ordena todos los demás por distancia: unos cuatrocientos puntos son más de cien mil comparaciones en cada cambio de tamaño.
- Cada línea es un trazo independiente.
- En pantallas de alta densidad (
devicePixelRatiode 1,5 o 2) el canvas se ve borroso. - Decide si seguir al ratón con
'ontouchstart' in window: un portátil con pantalla táctil deja de seguir al ratón.
La decisión en este sitio¶
- Una clase,
DotsField, sin estado global: recibe el canvas y la ventana, y exponestart()ystop(), ambos idempotentes. - Vecinos por celdas: en una cuadrícula regular, los cinco más cercanos están siempre a dos pasos; se buscan sólo ahí.
- Un trazo por punto (las cinco líneas en un mismo camino) y comparación por distancia al cuadrado, sin raíces.
- Alta densidad: el bitmap se escala por
devicePixelRatio; el dibujo no. pointermovey se ignora el toque (pointerType === 'touch').- Opacidad de los puntos al 20 % (Portify usa 50 %), con la misma caída por distancia.
- Un componente
shared-backgroundcon el canvas fijo, sin eventos de puntero, detrás del contenido; arranca conafterNextRendery sigue al interruptor de animaciones (Módulo A4).
El código¶
src/app/shared/animations/dots.ts:
src/app/shared/components/background/background.component.ts:
src/app/shared/components/background/background.component.scss:
App lo coloca antes del encabezado (<shared-background /> en app.html), y
main y el pie son position: relative para quedar por encima del canvas
(z-index: 0).
La prueba, dots.spec.ts:
Cómo funciona por dentro¶
gsap.ticker. Es el bucle de GSAP sobrerequestAnimationFrame;addyremoveregistran y quitan la función de dibujo. Con el mismo reloj que los tweens, el dibujo y la deriva de los puntos no se desincronizan.- La deriva es una cadena de tweens.
shiftmueve cada punto hasta media celda de su origen y, al terminar (onComplete), se llama a sí misma: nunca acaba. Al cambiar de tamaño hay que matar esos tweens (gsap.killTweensOf) antes de crear otros, o se acumulan. - Alta densidad.
canvas.width = ancho * ratiocrea más píxeles;setTransform(ratio, 0, 0, ratio, 0, 0)hace que el dibujo siga en píxeles CSS. El tamaño visible lo fija el CSS (width: 100%,height: 100%). - Distancia al cuadrado.
(dx² + dy²)se compara con umbrales ya elevados al cuadrado (4000, 20000, 40000): no hace faltaMath.sqrt. - Tres tramos de opacidad. Cerca del ratón los puntos y las líneas están más marcados; lejos, casi invisibles. Las líneas sólo se trazan si su opacidad es mayor que cero.
pointermove. Un ratón, un lápiz y un dedo generan eventos de puntero; elpointerTypelos distingue. En un teléfono el campo queda «despierto» en el centro de la ventana; en un portátil con pantalla táctil sigue al ratón.start()sin contexto 2D.canvas.getContext('2d')esnullen jsdom o en un navegador muy antiguo: no hay fondo y tampoco error.stop()limpia. Quita el ticker y los oyentes, mata los tweens y borra el canvas, porque puede volver a arrancar cuando se reactiva el interruptor.- El componente.
viewChild.requiredda el<canvas>; eleffectdel componente llama astart()ostop()según el interruptor, yDestroyRefdetiene el campo al destruirse.aria-hiddenypointer-events: nonelo hacen puramente decorativo. - Probar sin canvas. La prueba entrega un contexto falso que acepta cualquier llamada y comprueba el destino interno del campo (el único estado observable) tras eventos de puntero sintéticos.
Errores comunes¶
- Decidir con
ontouchstart. Es una propiedad que existe en muchos portátiles; el campo dejaba de seguir al ratón sin que nadie lo notara. - Olvidar matar los tweens al redimensionar. Cada cambio de tamaño sumaba una cadena de deriva por punto.
- Poner el canvas encima del contenido. Sin
z-index: 0y con el resto enposition: relative, el canvas tapa los clics; sinpointer-events: nonelos bloquea aunque quede detrás. - Un canvas con el tamaño del CSS y sin escalar el bitmap. Se ve borroso en pantallas de alta densidad.
- Ordenar todos los puntos para cada punto. Cuadrático y, en un campo de unos cientos de puntos, innecesario.
Preguntas de entrevista (senior)¶
1. ¿Cómo haces nítido un canvas en una pantalla de alta densidad?¶
Respuesta:
Con dos tamaños: el atributo width/height del canvas (el bitmap) se
multiplica por devicePixelRatio, y el tamaño visible lo fija el CSS. Después
se aplica setTransform(ratio, 0, 0, ratio, 0, 0) al contexto para seguir
dibujando en píxeles CSS. Sin eso, el navegador estira un bitmap de baja
resolución y todo sale borroso. Conviene recalcularlo al redimensionar, y el
coste de memoria crece con el cuadrado del ratio.
2. ¿Por qué pointermove y no mousemove o una comprobación de soporte táctil?¶
Respuesta:
Comprobar 'ontouchstart' in window mide lo que el dispositivo puede
hacer, no lo que la persona está haciendo: muchos portátiles con
pantalla táctil la tienen y por eso nunca recibían el ratón. Los eventos de
puntero unifican ratón, lápiz y dedo y traen pointerType, así que se
escucha siempre y se decide por evento. Es el patrón general: reaccionar a
la entrada real en lugar de adivinar la capacidad del dispositivo.
3. ¿Por qué comparar distancias al cuadrado?¶
Respuesta:
Porque ordenar o comparar por distancia da el mismo resultado con o sin raíz
cuadrada: si a < b entonces a² < b² para valores no negativos. Se evita
una operación costosa en un bucle que corre en cada frame para cientos de
puntos, y los umbrales se escriben ya elevados al cuadrado. El truco sólo
vale para comparar; si hubiera que mostrar la distancia, habría que calcular
la raíz.
Módulo A4: El interruptor de animaciones¶
Fuente: src/app/shared/services/motion.service.ts,
src/app/shared/components/motion-toggle/, src/styles/_base.scss y
src/app/shared/components/header/ del repositorio.
El problema que resuelve¶
El fondo de puntos se mueve sin parar, y un movimiento que dura más de cinco segundos exige, según la pauta WCAG 2.2.2 (nivel A), una forma de pausarlo u ocultarlo. Portify no la trae. El sitio necesitaba un control para apagar el movimiento, pero el movimiento tiene tres fuentes distintas: los reveals de GSAP, el lienzo y las animaciones y transiciones de CSS (las ondas del retrato, el relleno de los enlaces). Un interruptor que sólo apagara una dejaba el sitio a medias.
Hubo además una decisión de producto. La primera idea, nacida de un plan de
desarrollo, era respetar prefers-reduced-motion del sistema por defecto. En la
máquina de Janio Windows tiene esa preferencia activa y el sitio se veía
congelado sin que él lo hubiera pedido. Decidió el 13 de noviembre de 2026:
manda la app, no la máquina.
La decisión en este sitio¶
- Un servicio,
MotionService, con una señalenabled(por defecto encendida), una elección que se recuerda enlocalStoragey un atributodata-motion="off"en<html>cuando está apagado. - Las tres fuentes dependen de él: el inicializador de la coreografía (Módulo A1) y el fondo (Módulo A3) leen la señal; el CSS lee el atributo.
- No se consulta
prefers-reduced-motion, ni en JavaScript ni en CSS. La regla que lo hacía se sustituyó por una regla sobre el atributo. - Con el interruptor apagado se quitan las transiciones (
transition: none) en vez de acortarlas. - Un botón
role="switch"a la derecha de la barra del encabezado, con nombre fijo («Animations» / «Animaciones») y el estado enaria-checked. - En pantallas de menos de 370 px la etiqueta no se dibuja. Con el
encabezado fijo (el Módulo E7 de la Parte 2, que explica los estilos del menú) la barra tiene que caber en una fila, y
en un teléfono estrecho la etiqueta («Animations» mide 142 px, «Animaciones»
153 px) empujaba el botón del menú a una segunda fila. Se oculta sólo a la
vista (
clip-path, tamaño de 1 px): sigue en el DOM, así que el interruptor conserva su nombre accesible. - La elección guardada se aplica antes del primer pintado. Si sólo la
aplicara el servicio, quien apagó el movimiento vería un instante las ondas
del hero, porque Angular tarda en arrancar y en hidratar. Un script pequeño
en línea, al principio del
<head>desrc/index.html, lo evita:
Repite a propósito la clave (motion), el valor (off) y el atributo del
servicio, porque corre antes que Angular. Si el almacenamiento falla (una
ventana privada, datos del sitio bloqueados) la página se queda con el
movimiento encendido. Una prueba de contenido
(scripts/motion-first-paint.test.mjs) ejecuta ese script contra una página
falsa y comprueba que las tres cosas coinciden con motion.service.ts.
El código¶
src/app/shared/services/motion.service.ts:
src/app/shared/components/motion-toggle/motion-toggle.component.ts:
src/app/shared/components/motion-toggle/motion-toggle.component.html:
src/app/shared/components/motion-toggle/motion-toggle.component.scss:
La regla de CSS, al final de src/styles/_base.scss:
En header.component.html, el botón va dentro del grupo de la derecha, antes del
botón del menú: <shared-motion-toggle />. Las pruebas están en
motion.service.spec.ts y motion-toggle.component.spec.ts.
Cómo funciona por dentro¶
- Una señal para JavaScript, un atributo para CSS. El estado vive en la
señal
enabled;applylo refleja en el atributodata-motionde<html>. JavaScript reacciona a la señal; CSS, al selector:root[data-motion='off']. Una sola fuente de verdad con dos lectores. - El estado inicial. En el servidor (prerenderizado) el servicio no toca
nada: la página siempre sale encendida. En el navegador, el constructor lee
localStoragey, si encuentra'off', aplica el apagado. Todo acceso alocalStorageva entry/catch: puede lanzar en ventanas privadas o con los datos del sitio bloqueados, y el interruptor debe seguir funcionando para esa visita. - Cómo reacciona la coreografía. Un
effecten el inicializador del Módulo A1 observamotion.enabled(). Su primera ejecución sólo registra el estado inicial; las siguientes llaman arefresh(false): se revierte el contexto de GSAP y, si el movimiento está encendido, se vuelve a ejecutar la coreografía tras el siguiente render. Apagar devuelve todo al estado de CSS; encender reproduce las entradas desde el principio. - Cómo reacciona el fondo. Un
effectdel componente llama afield.start()ofield.stop();stop()borra el canvas. - Quitar frente a acortar las transiciones. Una transición acortada a
0,01 ms conserva su retraso. El menú móvil usa
visibility 0s linear 500mspara seguir visible durante la salida y desaparecer después; con el retraso intacto, al cerrarlo el panel salía de pantalla pero sus enlaces seguían en el orden de tabulación medio segundo.transition: noneelimina duración y retraso. Las animaciones sí se acortan (0,01 ms y una iteración) porque su estado final es el que importa. - El botón.
role="switch"yaria-checkedhacen que un lector de pantalla anuncie «Animaciones, interruptor, activado». El nombre no cambia con el estado: la regla es que el nombre dice qué es y el estado dice cómo está. El indicador visual (una píldora con un círculo) tienearia-hidden. - Por qué
data-motiony no una clase. Es un dato, no un estilo; y un atributo de datos en<html>no choca con las clases de ningún componente. - Pruebas. El servicio se comprueba con y sin valor guardado, y se
verifica que no consulta
matchMedia. El botón, que cambia de estado con cada clic y se etiqueta en cada idioma.
Errores comunes¶
- Apagar sólo una fuente. Un interruptor que detiene GSAP pero no el canvas ni el CSS deja moverse cosas que la persona quería quietas.
- Medio respetar el sistema. Mantener la regla CSS de
prefers-reduced-motiony no que JavaScript la mire (o al revés) da un sitio con ondas quietas y tarjetas animadas, según la máquina. - Acortar en vez de quitar transiciones con retraso. Deja una ventana en la que algo ya fuera de pantalla sigue en el orden de tabulación.
aria-pressedcon una etiqueta que cambia («Activar»/«Desactivar»). Se anuncia dos veces el estado y confunde; el nombre debe ser fijo.- Leer
localStoragesintry/catch. Lanza en ventanas privadas. - Apagar el movimiento sólo desde el servicio. Angular tarda en arrancar y
en hidratar; hasta entonces la página ya se pintó con las ondas. El script
del
<head>corre antes del primer pintado y el servicio sigue siendo la fuente de verdad después. - Cambiar la clave, el valor o el atributo en un sitio y no en el otro. El
script y el servicio repiten
motion,offydata-motion. La pruebascripts/motion-first-paint.test.mjsleemotion.service.tsy falla si dejan de coincidir. - Ocultar la etiqueta con
display: none. El botón se queda sin nombre accesible. Se oculta conclip-pathy un tamaño de 1 px.
Preguntas de entrevista (senior)¶
1. El sistema operativo ya tiene una preferencia de movimiento. ¿Por qué un interruptor propio, y por qué no consultar la preferencia?¶
Respuesta:
La preferencia del sistema es un buen valor por defecto para la mayoría de los sitios, y respetarla es lo recomendable. Aquí hubo una razón de producto: en la máquina del autor estaba activa de fábrica y el sitio se veía congelado sin que lo hubiera pedido, así que decidió que mande la aplicación. El interruptor propio cubre la necesidad de accesibilidad (poder detener un movimiento continuo) sin depender de lo que diga el equipo, y recuerda la elección por navegador. La contrapartida, que hay que decir en voz alta, es que quien ya había pedido menos movimiento al sistema lo ve activo hasta que lo apague.
2. Hay movimiento hecho con JavaScript (GSAP y un canvas) y con CSS. ¿Cómo mantienes un único control?¶
Respuesta:
Con una única fuente de verdad y dos lectores. El estado vive en una señal de
un servicio; JavaScript reacciona a ella con effect (revertir y volver a
ejecutar, detener y limpiar el canvas). Para CSS, el servicio refleja el
estado como un atributo en <html> y una regla :root[data-motion='off']
con !important detiene animaciones y transiciones en todos los
elementos. Así no hay que tocar ningún componente: añadir un efecto nuevo,
sea de GSAP o de CSS, queda cubierto sin pensar.
3. ¿Qué diferencia hay entre acortar una transición a 0,01 ms y eliminarla, y cuándo importa?¶
Respuesta:
Acortar la duración deja intactas las demás propiedades de la transición, en
particular el retraso (transition-delay). Una transición de visibility con
un retraso de 500 ms (un patrón habitual para ocultar un panel después de que
termine de deslizarse) sigue esperando medio segundo, y durante ese tiempo
un panel cerrado conserva sus enlaces en el orden de tabulación. transition:
none elimina duración y retraso a la vez. En animaciones (@keyframes) lo
habitual es acortar la duración, porque lo que importa es que lleguen al
estado final; en transiciones con retraso, quitarlas.
4. La elección guardada ya la lee el servicio. ¿Por qué además un script en línea en el <head>?¶
Respuesta:
Porque el servicio corre cuando Angular arranca, y para entonces el navegador
ya pintó la página con el movimiento encendido: quien lo apagó vería un instante
las ondas del hero en cada visita. Un script síncrono al principio del <head>
se ejecuta antes del primer pintado y pone data-motion="off" en <html>, que
es lo que lee el CSS. No sustituye al servicio: éste sigue guardando la
elección y sincronizando la señal que usan GSAP y el fondo de puntos.
El precio es repetir la clave, el valor y el atributo en dos sitios, y por eso
una prueba compara el script con el código del servicio. Dentro del script,
todo va en un try/catch: si el almacenamiento falla, la página sigue con el
movimiento encendido y nada se rompe. El servidor no lo ejecuta: el HTML
prerenderizado es siempre el de «encendido».
Qué sigue en esta parte¶
El grano de Portify (una textura fija con mezcla de color) no se implementó: pesa y no aporta al contenido. El interruptor de movimiento y el comportamiento del menú se pueden recorrer juntos en Navegación y movimiento.