Scrollcraft
Capitolul 7 din 15EN

GSAP: timeline-uri, scrub și fixare.

Când o scenă are mai multe părți care trebuie să rămână în pas cu scrollul, GSAP și pluginul lui ScrollTrigger țin socoteala. Fiecare tehnică de mai jos rulează live lângă codul ei.

Capitolul 7 din 154 min de citit

Ce vei învăța

La finalul capitolului
  1. 01Pui în ordine mai multe mișcări cu un timeline GSAP și parametrul lui de poziție.
  2. 02Legi un timeline de scroll cu ScrollTrigger: scrub, fixare, puncte de început și de sfârșit.
  3. 03Desenezi linii SVG și dezvălui text împărțit pe rânduri cu pluginurile gratuite GSAP.
  4. 04Cureți în React cu useGSAP și respecți mișcarea redusă cu gsap.matchMedia().

01 · Instalarea

Gratuit, cu toate pluginurile
a

Instalează

GSAP și toate pluginurile lui, inclusiv ScrollTrigger, SplitText și DrawSVG, sunt gratuite pentru uz comercial din 2025. Cu un bundler, instalează-l din npm. Pe o pagină simplă, încarcă fișierele de pe un CDN, în ordinea asta: întâi GSAP, apoi fiecare plugin.

bash
npm install gsap
b

Un singur ceas cu Lenis

Scrollul lin și ScrollTrigger trebuie să fie de acord unde se află pagina. Lasă Lenis să-i raporteze fiecare scroll lui ScrollTrigger și condu Lenis din ticker-ul GSAP, ca amândouă să se miște în același cadru.

html
<script src="https://cdn.jsdelivr.net/npm/gsap@3.15.1/dist/gsap.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/gsap@3.15.1/dist/ScrollTrigger.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/lenis@1.3.27/dist/lenis.min.js"></script>
<script>
  gsap.registerPlugin(ScrollTrigger);

  // Lenis și ScrollTrigger folosesc același ceas.
  const lenis = new Lenis({ lerp: 0.1 });
  lenis.on('scroll', ScrollTrigger.update);
  gsap.ticker.add((time) => lenis.raf(time * 1000));
  gsap.ticker.lagSmoothing(0);
</script>

Fără ticker-ul comun, secțiunile fixate rămân în urmă cu un cadru și tremură vizibil.

02 · Cinci tehnici, live

Derulează în fiecare previzualizare
1

Timeline

Un timeline redă pașii în ordine. Parametrul de poziție îi suprapune, așa că trei mișcări mici se citesc ca o singură intrare.

Folosește -=0.6 ca să începi înainte să se termine pasul anterior și <0.2 ca să începi imediat după ce a pornit.

HTML
<script src="https://cdn.jsdelivr.net/npm/gsap@3.15.1/dist/gsap.min.js"></script>
<section class="hero">
  <h1>
    <span class="ln"><span>Sound that</span></span>
    <span class="ln"><span>fills the room.</span></span>
  </h1>
  <p class="sub">A small speaker that plays in every direction.</p>
  <a class="cta" href="#">Pre-order</a>
</section>
2

Scrub

Cu scrub, poziția scrollului devine capul de redare: derulând în jos, timeline-ul merge înainte; derulând în sus, se întoarce.

Un număr precum scrub: 0.6 lasă capul de redare să ajungă din urmă în 0,6 secunde, ceea ce netezește o rotiță sacadată.

HTML
<script src="https://cdn.jsdelivr.net/npm/gsap@3.15.1/dist/gsap.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/gsap@3.15.1/dist/ScrollTrigger.min.js"></script>
<section class="stage">
  <div class="frame"><div class="box"></div></div>
</section>
<p class="after">The timeline follows the scroll, both ways.</p>
3

Fixare

Fixarea ține o secțiune pe loc cât cititorul continuă să deruleze și îi dă timeline-ului distanța aceea ca să ruleze.

Setează end: '+=200%' ca să fixezi pe două înălțimi de ecran. Fixează o singură secțiune o dată și niciodată într-un părinte transformat.

HTML
<script src="https://cdn.jsdelivr.net/npm/gsap@3.15.1/dist/gsap.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/gsap@3.15.1/dist/ScrollTrigger.min.js"></script>
<p class="lead">Scroll down.</p>
<section class="pin">
  <div class="bar"><i></i></div>
  <article><h2>Listen</h2><p>A week of questions before any sketch.</p></article>
  <article><h2>Reduce</h2><p>One idea, said as plainly as possible.</p></article>
  <article><h2>Move</h2><p>Motion rules, so the brand behaves the same everywhere.</p></article>
</section>
<p class="lead">The section let go.</p>
4

Desenează o linie SVG

DrawSVG animă cât din contur se vede. Legat de un trigger cu scrub, un traseu sau o semnătură se desenează singur pe măsură ce cititorul înaintează.

getPointAtLength dă capătul liniei desenate, ca un marcaj să meargă de-a lungul ei.

HTML
<script src="https://cdn.jsdelivr.net/npm/gsap@3.15.1/dist/gsap.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/gsap@3.15.1/dist/ScrollTrigger.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/gsap@3.15.1/dist/DrawSVGPlugin.min.js"></script>
<section class="stage">
  <div class="frame">
    <svg viewBox="0 0 300 200" aria-hidden="true">
      <path class="ghost" d="M20 170 C 70 20, 120 20, 150 100 S 230 180, 280 30" />
      <path class="line" d="M20 170 C 70 20, 120 20, 150 100 S 230 180, 280 30" />
      <circle class="dot" r="5" cx="20" cy="170" />
    </svg>
  </div>
</section>
<p class="after">DrawSVG draws the stroke; the dot rides along the same path.</p>
5

Împarte textul pe rânduri

SplitText găsește rupturile reale de rând după ce se încarcă fonturile, pune fiecare rând într-o mască și te lasă să le animezi unul după altul.

autoSplit: true împarte din nou când se schimbă lățimea, iar dacă întorci animația din onSplit, GSAP o curăță pe cea veche.

HTML
<script src="https://cdn.jsdelivr.net/npm/gsap@3.15.1/dist/gsap.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/gsap@3.15.1/dist/ScrollTrigger.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/gsap@3.15.1/dist/SplitText.min.js"></script>
<p class="lead">Scroll down.</p>
<h2 class="title">Quiet pages that move only when it matters, and say one thing at a time.</h2>
<p class="lead"></p>

03 · În React și Next.js

useGSAP
a

Curăță la demontare

Hook-ul useGSAP din @gsap/react limitează fiecare selector la o componentă și anulează fiecare animație și trigger când aceasta se demontează, așa că navigarea fără reîncărcare nu lasă nimic în urmă.

tsx
// components/Reveal.tsx
'use client';
import { useRef, type ReactNode } from 'react';
import gsap from 'gsap';
import { ScrollTrigger } from 'gsap/ScrollTrigger';
import { useGSAP } from '@gsap/react';

gsap.registerPlugin(useGSAP, ScrollTrigger);

export default function Reveal({ children }: { children: ReactNode }) {
  const root = useRef<HTMLDivElement>(null);

  // Tot ce se creează aici e limitat la root și anulat la demontare.
  useGSAP(() => {
    const mm = gsap.matchMedia();
    mm.add('(prefers-reduced-motion: no-preference)', () => {
      gsap.from('.reveal', {
        y: 28, opacity: 0, duration: 0.9, ease: 'power3.out', stagger: 0.08,
        scrollTrigger: { trigger: root.current, start: 'top 80%', once: true },
      });
    });
  }, { scope: root });

  return <div ref={root}>{children}</div>;
}
b

Respectă reducerea mișcării cu matchMedia

gsap.matchMedia() construiește animațiile doar cât timp un media query se potrivește și le anulează când nu se mai potrivește. Fiecare previzualizare din capitol își pune animațiile de scroll în (prefers-reduced-motion: no-preference).

04 · Timeline-uri de scroll în CSS

Mai puțin JavaScript, verifică suportul

CSS poate acum lega o animație de scroll cu animation-timeline. Blogul WebKit descrie suportul într- un beta Safari 26. Verifică tabelul actual de pe caniuse.com pentru Chrome și Firefox și păstrează o variantă de rezervă.

css
@keyframes rise {
  from { opacity: 0; transform: translateY(28px); }
  to   { opacity: 1; transform: none; }
}

/* Doar unde browserul înțelege timeline-urile de scroll. */
@supports (animation-timeline: view()) {
  .reveal {
    animation: rise linear both;
    animation-timeline: view();
    animation-range: entry 0% entry 60%;
  }
  .progress {
    transform-origin: 0 50%;
    animation: grow linear both;
    animation-timeline: scroll(root);
  }
}
@keyframes grow { from { transform: scaleX(0); } to { transform: scaleX(1); } }
js
const native = CSS.supports('animation-timeline: view()');
if (!native) {
  // revino la aparițiile cu IntersectionObserver, ca în site-ul de exemplu
}

Un compromis: un view timeline merge în ambele sensuri, așa că, atunci când derulezi înapoi în sus, conținutul dispare din nou. Varianta cu IntersectionObserver din exemplu îl lasă vizibil. Alege comportamentul pe care îl vrei.

05 · Când apelezi la GSAP

a

Rămâi la cod simplu

O apariție, o bară de progres sau un strat de parallax. Capitolul Mișcare le face pe fiecare în câteva rânduri, fără nimic de descărcat.

b

Folosește GSAP

Mai multe elemente care trebuie să se miște într-o ordine fixă, o scenă fixată, un scrub care trebuie să se întoarcă exact, text împărțit după rupturile reale de rând sau desen SVG.

c

Folosește-le pe amândouă

Majoritatea site-urilor din producție le combină: CSS și IntersectionObserver pentru aparițiile mici, GSAP pentru cele două-trei scene care duc povestea.

Practică · Lucrul cu AI

Aceeași sarcină, în unealta ta

Codul GSAP greșește în feluri previzibile: plugin neînregistrat, triggere măsurate prea devreme, nicio curățenie. Numește-le în prompt.

Deschide un terminal în folderul proiectului și rulează claude. Apasă Shift+Tab până se pornește modul plan, lipește promptul, citește planul, apoi aprobă-l. Regulile proiectului stau în CLAUDE.md.

O scenă fixată

Prompt
Citește CLAUDE.md. Adaugă o scenă fixată în site-ul pentru [subiect] cu GSAP 3.15.1 și ScrollTrigger de pe jsDelivr: secțiunea rămâne fixată pe 200% din înălțimea ecranului, cât trei pași își predau locul unul după altul, cu o linie de progres. Înregistrează pluginul, construiește totul în gsap.matchMedia ca nimic să nu se animeze sub prefers-reduced-motion (pașii stau unul sub altul) și apelează ScrollTrigger.refresh() după ce se încarcă imaginile. Arată-mi întâi planul.

Verifică triggerele

Prompt
Pornește temporar markerele ScrollTrigger și spune-mi unde începe și unde se termină fiecare trigger la 375 și la 1440 de pixeli lățime. Apoi scoate markerele. Nu schimba nimic altceva.

Practică · Exerciții

Încearcă, apoi compară
1

Citește parametrul de poziție

În tl.to(a, {…}).to(b, {…}, "-=0.4").to(c, {…}, "<"), când pornește fiecare tween?

Indiciu: „<” se referă la începutul tween-ului anterior.

Arată soluția

a pornește la 0. b pornește cu 0,4 secunde înainte să se termine a. c pornește în același moment cu b.

2

Scrub sau redare

Pentru un titlu care apare o singură dată și pentru un produs care se rotește cât derulezi, alege între scrub și toggleActions.

Indiciu: animația urmează scrollul în ambele sensuri?

Arată soluția

Titlul se redă o dată, cu toggleActions: "play none none none" (sau once: true). Produsul care se rotește folosește scrub, ca să meargă înainte și înapoi exact cu scrollul.

3

Curăță în React

O componentă creează un ScrollTrigger în useEffect, fără curățenie. Ce se întâmplă după ce pleci de pe pagină și revii de trei ori?

Indiciu: nimic nu elimină triggerele vechi.

Arată soluția

Există patru seturi de triggere, trei legate de elemente care nu mai există, așa că pozițiile sunt greșite și se muncește degeaba. Folosește useGSAP cu un scope, care anulează totul la demontare.

tsx
useGSAP(() => {
  gsap.from('.reveal', { y: 28, opacity: 0, scrollTrigger: { trigger: root.current, start: 'top 80%' } });
}, { scope: root });

Practică · Proiectul cursului

Un site, construit pe tot parcursul

Dă site-ului pentru [subiect] o scenă pe care doar GSAP o face ușoară: o secvență fixată care spune o parte din poveste.

  1. Alege partea poveștii care are trei momente și scrie-le în notes.md.
  2. Rulează „O scenă fixată” și verific-o la trei lățimi.
  3. Rulează „Verifică triggerele” și ajustează începutul și sfârșitul dacă un pas apare prea devreme sau prea târziu.
  4. Fă commit, cu versiunea GSAP fixată în adresa scriptului.

Practică · Testează

Verifici rezultatul
  • Secțiunea se fixează și se eliberează fără salt sau gol la 375, 768 și 1440 de pixeli.
  • Când derulezi înapoi, scena se redă exact invers.
  • Cu mișcarea redusă pornită, nimic nu e fixat, iar cei trei pași se citesc ca o listă.
  • Consola nu arată avertismente despre pluginuri sau ținte lipsă.

Practică · Evaluare

Criterii de acceptare

0 din 4 criterii îndeplinite

Urmează WebGL

O scenă three.js condusă de scroll, particule mutate pe placa video, un shader pe tot ecranul și o tranziție între două scene.

Scurtături de tastatură: [ capitolul anterior · ] capitolul următor