12k
All articles

Leitfaden für barrierefreie Animationen mit GSAP

Erstellen Sie barrierefreie GSAP-Animationen mit matchMedia und prefers-reduced-motion. Vereinfachen Sie ScrollTrigger, ergänzen Sie Pausensteuerungen und testen Sie Bewegungseinstellungen.

OpenReplay Team
OpenReplay Team
Leitfaden für barrierefreie Animationen mit GSAP

Der Standardweg, prefers-reduced-motion in GSAP zu berücksichtigen, ist gsap.matchMedia() mit einem Conditions-Objekt. GSAP führt Ihre Setup-Funktion für die jeweils zutreffende Bewegungspräferenz aus. Ändert der Nutzer diese Einstellung, setzt GSAP alles zurück, was die Funktion erstellt hat, und führt sie erneut aus.

Meist beschäftigen sich Teams mit diesem Thema, nachdem ein Barrierefreiheits-Audit einen per Scroll gepinnten Hero-Bereich oder ein endlos laufendes Laufband (Marquee) bemängelt hat. Die Designer wollen dann nicht, dass die Seite zur Behebung in ein statisches PDF verwandelt wird.

Die Media Query abzufragen ist nur ein Teil der Arbeit. Ein barrierefreies GSAP-Setup braucht außerdem:

  • ruhigere ScrollTrigger,
  • eine Pause-Steuerung,
  • Inhalte, die sichtbar bleiben, falls das Skript nie ausgeführt wird,
  • und eine Möglichkeit, all das zu testen.

Hintergrundwissen zur Media Query selbst finden Sie in OpenReplays Leitfaden zu prefers-reduced-motion. gsap.matchMedia() erfordert GSAP 3.11.0 oder neuer.

Das Wichtigste in Kürze

  • gsap.matchMedia() setzt alle Animationen und ScrollTrigger zurück, die in einer Setup-Funktion erstellt wurden, sobald deren Query nicht mehr zutrifft. Eine Änderung der Systemeinstellung „Bewegung reduzieren“ greift dadurch ohne Neuladen der Seite.
  • Ersetzen Sie bei reduzierter Bewegung große Verschiebungen, Rotationen und Skalierungen durch ein kurzes Einblenden über die Opazität, damit der Inhalt trotzdem erscheint.
  • Ein ScrollTrigger-Zweig für reduzierte Bewegung sollte auf pin und scrub verzichten und jedes Element einfach einblenden, sobald es in den Viewport kommt.
  • WCAG 2.2.2 Pause, Stop, Hide (Konformitätsstufe A) verlangt für automatisch startende Bewegung eine Möglichkeit zum Pausieren, Stoppen oder Ausblenden. Eine Abfrage von prefers-reduced-motion allein erfüllt dieses Kriterium nicht.
  • Gestalten Sie animierte Inhalte so, dass sie schon im Standard-CSS-Zustand lesbar sind. So bleibt nichts bei opacity: 0 stehen, wenn keine Animation läuft.

Verzweigung nach prefers-reduced-motion in GSAP mit gsap.matchMedia()

gsap.matchMedia() führt eine Setup-Funktion nur aus, solange die zugehörige Query zutrifft. Trifft sie nicht mehr zu, setzt GSAP alle Animationen und ScrollTrigger zurück, die die Funktion erstellt hat. Als Query können Sie ein Conditions-Objekt übergeben. Der Handler liest dann jede Bedingung als Boolean aus context.conditions.

const mm = gsap.matchMedia();
const conditions = {
  isMotion: "(prefers-reduced-motion: no-preference)",
  isReduced: "(prefers-reduced-motion: reduce)",
};

mm.add(conditions, (context) => {
  const { isMotion, isReduced } = context.conditions;

  if (isMotion) {
    gsap.from(".hero-card", { opacity: 0, x: -200, rotation: -8, duration: 1 });
  }
  if (isReduced) {
    gsap.from(".hero-card", { opacity: 0, duration: 0.4 });
  }
});

Ziel ist es, Bewegung zu reduzieren, nicht sie vollständig zu entfernen. Im reduzierten Zweig werden die weite horizontale Bewegung und die Rotation zu einem kurzen Einblenden. Die Karte erscheint weiterhin und lenkt die Aufmerksamkeit auf sich, aber nichts bewegt sich mehr über den Bildschirm.

GSAPs Leitfaden für barrierefreie Animationen bietet Kriterien dafür, wann Sie eine Animation vereinfachen und wann Sie ganz auf sie verzichten sollten. matchMedia() nutzt intern gsap.context(). Verschachteln Sie es also nicht zusätzlich in einem weiteren Context.

ScrollTrigger bei reduzierter Bewegung beruhigen

Ein ScrollTrigger-Zweig für reduzierte Bewegung sollte auf pin und scrub verzichten und jedes Element einblenden, sobald es in den Viewport kommt. Pinning übernimmt die Kontrolle über das Scrollen des Nutzers, und Scrubbing koppelt Bewegung an jede Scroll-Geste. Genau das soll der reduzierte Zweig vermeiden.

mm.add(conditions, (context) => {
  if (context.conditions.isMotion) {
    const tl = gsap.timeline({
      scrollTrigger: { trigger: ".story", pin: true, scrub: 1, end: "+=200%" },
    });
    tl.from(".story-step", { opacity: 0, y: 100, stagger: 0.5 });
  } else {
    gsap.utils.toArray(".story-step").forEach((step) => {
      gsap.from(step, { opacity: 0, duration: 0.4, scrollTrigger: { trigger: step } });
    });
  }
});

In seiner einfachsten Form spielt ein ScrollTrigger seine Animation einmal ab, sobald das Trigger-Element in den Viewport kommt. Das passt gut zu einem Einblenden. Sie müssen nichts manuell beenden: Ändert sich die Präferenz, setzt matchMedia die gepinnte Timeline zurück und baut die Variante mit Einblenden auf.

Muster für Pinning und Scrub im Zweig mit voller Bewegung finden Sie in OpenReplays ScrollTrigger-Anleitung. Session-Replays können zeigen, wie Nutzer schnell über gepinnte Abschnitte hinwegscrollen oder mitten in einer Animation anhalten. Daran erkennen Sie, wo die Bewegung sie behindert.

Pause-Steuerung und ein Bewegungsschalter auf der Seite

WCAG 2.2.2 Pause, Stop, Hide ist ein Erfolgskriterium der Stufe A. Es verlangt eine Möglichkeit, bewegte Inhalte zu pausieren, zu stoppen oder auszublenden, wenn diese:

  • automatisch starten,
  • länger als fünf Sekunden dauern
  • und neben anderen Inhalten erscheinen.

prefers-reduced-motion zu berücksichtigen erfüllt WCAG 2.2.2 nicht. Nutzer, die ihre Systemeinstellung nie geändert haben, sehen weiterhin die volle Animation. Das W3C-Understanding-Dokument zu 2.2.2 empfiehlt zudem: Enthält eine Seite mehrere bewegte, blinkende, scrollende oder sich automatisch aktualisierende Elemente, sollten Sie einen einzigen Mechanismus bereitstellen, der alle steuert.

KriteriumStufeGSAP-Technik
2.2.2 Pause, Stop, HideAPause-Button, der timeline.pause() / timeline.play() aufruft
2.3.3 Animation from InteractionsAAAReduced-Motion-Zweig in gsap.matchMedia()

WCAG 2.2.2 und 2.3.3 betreffen unterschiedliche Arten von Bewegung. 2.3.3 gilt für Bewegung, die durch Nutzerinteraktion ausgelöst wird. 2.2.2 gilt für Bewegung, die die Seite selbst startet. Die übergeordneten Richtlinien behandelt OpenReplays Überblick über barrierefreie Animationen.

const toggle = document.querySelector("#reduce-motion");
const pauseBtn = document.querySelector("#pause-motion");
toggle.checked = window.matchMedia("(prefers-reduced-motion: reduce)").matches;
toggle.addEventListener("change", gsap.matchMediaRefresh);

mm.add(conditions, (context) => {
  const reduce = context.conditions.isReduced || toggle.checked;
  pauseBtn.hidden = reduce;
  if (reduce) return; // marquee stays static

  const tl = gsap.timeline({ repeat: -1 });
  tl.to(".marquee-track", { xPercent: -50, duration: 20, ease: "none" });
  pauseBtn.textContent = "Pause animation";

  const onClick = () => {
    tl.paused() ? tl.play() : tl.pause();
    pauseBtn.textContent = tl.paused() ? "Play animation" : "Pause animation";
  };
  pauseBtn.addEventListener("click", onClick);
  return () => pauseBtn.removeEventListener("click", onClick);
});

Diese drei Methoden steuern die Timeline:

  • pause() pausiert die Instanz und kann optional zu einem bestimmten Zeitpunkt springen. Ohne Argument hält sie an der aktuellen Position des Playheads an.
  • play() setzt die Wiedergabe von dort fort und stellt sicher, dass die Instanz weder pausiert noch rückwärts abgespielt wird.
  • paused() funktioniert ohne Argument als Getter, sodass Sie damit umschalten können.

gsap.matchMediaRefresh() setzt alle aktiven matchMedia-Setups zurück und führt diejenigen, die weiterhin zutreffen, erneut aus. Die Checkbox baut dadurch sofort alle Animationen neu auf.

Die Logik in reduce = isReduced || toggle.checked folgt einer klaren Regel: Der Schalter kann zusätzliche Reduzierung bewirken, aber niemals eine vom Betriebssystem angeforderte reduzierte Bewegung aufheben. Die Cleanup-Funktion entfernt nur den Listener. Rufen Sie darin nicht context.revert() auf, denn matchMedia übernimmt das Zurücksetzen selbst.

Inhalte sichtbar halten, falls die Animation nie ausgeführt wird

Animierte Inhalte sollten im Standard-CSS-Zustand vollständig lesbar sein. Schlägt das Skript fehl oder wird kein matchMedia-Zweig ausgeführt, bleibt dann nichts bei opacity: 0 oder visibility: hidden stehen. Das kommt in der Praxis tatsächlich vor: Ein gsap.matchMedia()-Handler, der auf einem Conditions-Objekt basiert, wird überhaupt nicht ausgeführt, wenn keine der Bedingungen zutrifft.

/* Avoid: content is invisible until JavaScript reveals it */
.reveal { opacity: 0; }
// Prefer: CSS leaves .reveal visible; GSAP animates from hidden to that state
mm.add(conditions, () => {
  gsap.from(".reveal", { opacity: 0, duration: 0.4 });
});

gsap.from() animiert von den übergebenen Werten zum aktuellen Zustand des Elements. Der Ruhezustand bleibt also sichtbar, und nur die Animation selbst blendet das Element jemals aus.

Dasselbe gilt für autoAlpha, die GSAP-Eigenschaft, die Opazität und Sichtbarkeit kombiniert. Animieren Sie Inhalte von autoAlpha: 0 aus. Verstecken Sie sie nicht per CSS mit opacity: 0 und visibility: hidden, um dann darauf zu warten, dass ein Tween sie sichtbar macht.

Fokusreihenfolge bei bewegten Elementen

GSAP-Transformationen wie x, y und scale verschieben ein Element visuell, ändern aber nicht seine Position im DOM. Tastaturfokus und Screenreader-Reihenfolge folgen daher dem Markup, nicht der Animation. Halten Sie das DOM in einer logischen Lesereihenfolge, und animieren Sie keine Layout-Eigenschaften, um eine andere Reihenfolge vorzutäuschen.

Bewegen Sie kein Element, während es den Fokus hat. Machen Sie interaktive Elemente erst klickbar, wenn sie ihre Endposition erreicht haben. Ein Button, der unter dem Cursor hindurchgleitet, ist ein Ziel, das sich wegbewegt.

Bei animiertem Text berücksichtigt SplitText Screenreader standardmäßig. Mit aria: "auto" fügt es dem aufgeteilten Element ein aria-label mit dessen Text hinzu. Die enthaltenen Zeilen-, Wort- und Zeichenelemente erhalten aria-hidden. So stellt der Accessibility Tree eine einzige lesbare Zeichenkette statt einzelner Fragmente bereit.

Diese Voreinstellung funktioniert bei Überschriften. ARIA verbietet aria-label jedoch auf generischen Elementen wie einem einfachen <div>, <span> oder <p>, und Barrierefreiheitsprüfer melden es dort als Fehler. Verwenden Sie für solche Elemente aria: "none", das keine ARIA-Attribute hinzufügt, und stellen Sie eine nur für Screenreader bestimmte Kopie des Textes bereit. Dasselbe gilt, wenn der aufgeteilte Text verschachtelte Links enthält, die angesagt werden müssen.

Wie testet man reduzierte Bewegung in GSAP?

Testen Sie beide GSAP-Bewegungszweige, indem Sie die Reduced-Motion-Präferenz bei geöffneter Seite umschalten. Da gsap.matchMedia() auf Änderungen reagiert, sollten die Animationen ohne Neuladen wechseln. Dafür gibt es zwei Wege:

  • Systemeinstellung: Aktivieren Sie die Einstellung „Bewegung reduzieren“ des Betriebssystems. Wo sie auf der jeweiligen Plattform zu finden ist, beschreibt MDN unter prefers-reduced-motion – Nutzereinstellungen.
  • Emulation in Chrome: Öffnen Sie in den Chrome DevTools den Tab „Rendering“, suchen Sie „Emulate CSS media feature prefers-reduced-motion“ und wählen Sie prefers-reduced-motion: reduce.

Prüfen Sie Folgendes:

  1. Gepinnte Abschnitte werden nicht mehr gepinnt.
  2. Endlos laufende Bewegung ist entweder verschwunden oder hat einen funktionierenden Pause-Button, der per Tastatur erreichbar ist.
  3. Bei deaktiviertem JavaScript sind alle Inhalte weiterhin sichtbar.
  4. Der Schalter auf der Seite baut die Animationen sofort neu auf.

Fazit

Ein barrierefreies GSAP-Setup bewahrt das Design und gibt den Nutzern die Kontrolle darüber. Es beruht auf vier Bausteinen:

  • matchMedia ersetzt große Bewegungen durch Einblendungen und bleibt mit der Systemeinstellung synchron.
  • ScrollTrigger verzichtet im reduzierten Zweig auf Pinning.
  • Ein echter Button pausiert alles, was länger läuft.
  • Inhalte bleiben auch ohne JavaScript sichtbar.

Beginnen Sie mit der gepinnten oder endlos laufenden Animation, die Ihr Audit bemängelt hat. Schreiben Sie dafür den reduzierten Zweig und die Pause-Steuerung, und testen Sie beides per DevTools-Emulation, bevor Sie sich der nächsten Animation widmen.

FAQs

Wie verwende ich gsap.matchMedia() für reduzierte Bewegung in React?

Erstellen Sie die matchMedia-Instanz innerhalb des Effects und geben Sie eine Cleanup-Funktion zurück, die mm.revert() aufruft. Das Zurücksetzen der Instanz setzt alle Animationen und ScrollTrigger zurück, die ihre Handler erstellt haben. Ein separater gsap.context() ist daher überflüssig. Das Cleanup ist in der Entwicklung wichtig: Der React Strict Mode mountet Komponenten, unmountet sie und mountet sie erneut, wodurch dieselbe Animation sonst zweimal starten kann.

Stoppt ein CSS-Reset für prefers-reduced-motion GSAP-Animationen?

Nein. Eine globale CSS-Regel, die innerhalb eines prefers-reduced-motion: reduce-Blocks die Dauer von Animationen und Transitions verkürzt, wirkt sich nur auf CSS-Animationen und -Transitions aus. GSAP animiert per JavaScript, indem es in jedem Frame Inline-Style-Werte schreibt. Seine Tweens und ScrollTrigger laufen also weiter. Behandeln Sie GSAP-Bewegung mit einem reduzierten Zweig in gsap.matchMedia(), und nutzen Sie den CSS-Reset für CSS-gesteuerte Bewegung.

Was passiert mit einer laufenden GSAP-Animation, wenn der Nutzer die Reduced-Motion-Einstellung ändert?

gsap.matchMedia() setzt sie zurück und führt den Handler für die neue Präferenz erneut aus. Beim Zurücksetzen werden die von den Animationen hinzugefügten Inline-Styles entfernt und die im Handler erstellten ScrollTrigger samt Pinning zurückgesetzt. Der nun zutreffende Zweig baut seine Animationen anschließend von Grund auf neu auf. Ein halb abgeschlossener Tween mit voller Bewegung wird also nicht fortgesetzt. Die reduzierte Variante startet vom Standard-CSS-Zustand des Elements.

DevTools for the frontend

Gain Debugging Superpowers

Unleash the power of session replay to reproduce bugs, track slowdowns and uncover frustrations in your app. Get complete visibility into your frontend with OpenReplay — the most advanced open-source session replay tool for developers.

Star on GitHub12k

We use cookies to improve your experience. By using our site, you accept cookies.