Nelle parole della skill
gsap-core è la skill di ingresso per il motore core di GSAP: tween singoli con gsap.to(), gsap.from(), gsap.fromTo() e gsap.set(), oltre alle vars comuni — duration (predefinito 0.5), delay, ease (predefinito power1.out), stagger, overwrite e immediateRender. Documenta gli alias di trasformazione di GSAP (x, y, scale, rotation, xPercent), autoAlpha per le dissolvenze, clearProps, i valori basati su funzione e relativi, e gsap.defaults() a livello di progetto.
Un'ampia sezione tratta gsap.matchMedia() per i breakpoint responsive e prefers-reduced-motion, chiudendo con un elenco ufficiale di best practice e una sezione Do Not. È scritta per designer e sviluppatori che scrivono o revisionano animazioni GSAP in React, Vue, Svelte o vanilla JS.
Che cosa produce
- Elementi DOM animati tramite CSSPlugin, incluso nel motore core e che non richiede plugin aggiuntivi.
- Un'istanza Tween restituita da ogni metodo tween, che si memorizza quando è necessario metterla in pausa, avviarla, invertirla, terminarla o scorrerla (scrub).
- Trasformazioni scritte come alias e applicate in un ordine fisso: translation, scale, rotationX/Y, skew, rotation.
- Animazioni e ScrollTrigger creati all'interno di un handler matchMedia, ripristinati automaticamente non appena la query non corrisponde più.
Come funziona
- 01Scegliere il Metodo Tween
gsap.to() anima dallo stato attuale ai valori passati ed è la chiamata più comune; from() inverte questo comportamento per le entrate, fromTo() dichiara esplicitamente entrambi gli estremi senza leggere i valori attuali, e set() applica istantaneamente con durata 0.
- 02Scrivere le Vars in camelCase
I nomi delle proprietà all'interno dell'oggetto vars devono essere in camelCase, quindi proprietà CSS come background-color o font-size diventano backgroundColor e fontSize.
- 03Offset con Stagger
Un numero semplice su stagger rappresenta i secondi tra ogni target; la forma a oggetto aggiunge opzioni come amount con una direzione from, oppure each con from: "random".
- 04Scegliere un Ease
Gli ease sotto forma di stringa coprono la maggior parte dei casi — power1.out è la sensazione predefinita, con back.out(1.7), elastic.out(1, 0.3), power3.inOut e none come alternative documentate.
- 05Calcolare i Valori per Ciascun Target
Una funzione passata come valore vars viene chiamata una volta per ciascun target al primo render, così valori basati sull'indice come x: (i) => i * 50 possono essere distribuiti su un intero set.
- 06Limitare il Lavoro alle Media Query
gsap.matchMedia() esegue il suo handler di setup solo mentre la query corrisponde, ed è così che la skill gestisce i breakpoint responsivi e gli utenti con reduced-motion.