Guide des animations accessibles avec GSAP
Créez des animations GSAP accessibles avec matchMedia et prefers-reduced-motion. Simplifiez ScrollTrigger, ajoutez des commandes de pause et testez les préférences de mouvement.
La méthode standard pour gérer prefers-reduced-motion dans GSAP consiste à utiliser gsap.matchMedia() avec un objet de conditions. GSAP exécute votre fonction de configuration selon la préférence de mouvement qui correspond. Lorsque l’utilisateur modifie ce réglage, GSAP annule tout ce que la fonction a créé, puis l’exécute à nouveau.
Les équipes y viennent généralement après un audit d’accessibilité qui a signalé une section hero épinglée au défilement ou un bandeau défilant en boucle (marquee). Les designers, eux, ne veulent pas que la page se transforme en PDF statique pour corriger le problème.
Tester la media query ne représente qu’une partie du travail. Une configuration GSAP accessible nécessite aussi des ScrollTriggers plus sobres, une commande de mise en pause, un contenu qui reste visible si le script ne s’exécute jamais, et un moyen de tester l’ensemble. Pour en savoir plus sur la media query elle-même, consultez le guide d’OpenReplay sur prefers-reduced-motion. gsap.matchMedia() nécessite GSAP 3.11.0 ou une version ultérieure.
Points clés
gsap.matchMedia()annule toutes les animations et tous les ScrollTriggers créés dans une fonction de configuration dès que sa query ne correspond plus. Une modification du réglage de réduction des animations du système d’exploitation prend donc effet sans rechargement de la page.- En mode mouvement réduit, remplacez les grands déplacements, les rotations et les changements d’échelle par un court fondu d’opacité, afin que le contenu continue d’apparaître.
- Une branche ScrollTrigger à mouvement réduit doit abandonner
pinetscrubet se contenter de faire apparaître chaque élément en fondu lorsqu’il entre dans le viewport. - Le critère WCAG 2.2.2 Mettre en pause, arrêter, masquer (niveau A) exige une commande de mise en pause, d’arrêt ou de masquage pour tout mouvement automatique. Un test de prefers-reduced-motion ne suffit pas, à lui seul, à le satisfaire.
- Laissez le contenu animé lisible dans son état CSS par défaut, afin que rien ne reste à
opacity: 0si aucune animation ne s’exécute.
Créer des branches prefers-reduced-motion dans GSAP avec gsap.matchMedia()
gsap.matchMedia() n’exécute une fonction de configuration que tant que sa query correspond. Lorsque la query ne correspond plus, elle annule toutes les animations et tous les ScrollTriggers créés par la fonction. Vous pouvez passer un objet de conditions en guise de query. Le handler lit alors chaque condition sous forme de booléen depuis 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 });
}
});
L’objectif est de réduire le mouvement, pas de le supprimer. Dans la branche réduite, le grand déplacement horizontal et la rotation deviennent un court fondu. La carte apparaît toujours et attire toujours l’attention, mais rien ne traverse l’écran. Le guide des animations accessibles de GSAP propose une grille de critères pour décider quand simplifier une animation et quand la supprimer complètement. matchMedia() encapsule gsap.context() en interne : ne l’enveloppez donc pas dans un second contexte.
Adoucir ScrollTrigger en mode mouvement réduit
Une branche ScrollTrigger à mouvement réduit doit abandonner pin et scrub et faire apparaître chaque élément en fondu lorsqu’il entre dans le viewport. L’épinglage prend le contrôle du défilement de l’utilisateur, et le scrub lie le mouvement à chaque geste de défilement. Ce sont précisément les deux comportements que la branche réduite doit éviter.
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 } });
});
}
});
Dans sa forme la plus simple, un ScrollTrigger joue son animation une seule fois, lorsque l’élément déclencheur entre dans le viewport, ce qui convient parfaitement à un fondu. Vous n’avez rien à détruire manuellement : si la préférence change, matchMedia annule la timeline épinglée et construit la version en fondu. Pour les modèles d’épinglage et de scrub côté mouvement complet, consultez le tutoriel ScrollTrigger d’OpenReplay. Les replays de session peuvent montrer des utilisateurs qui font défiler rapidement les sections épinglées ou qui s’arrêtent au milieu d’une animation, ce qui indique les endroits où le mouvement les gêne.
Commandes de pause et bascule de mouvement intégrée à la page
Le critère WCAG 2.2.2 Mettre en pause, arrêter, masquer (Pause, Stop, Hide) est un critère de niveau A. Il exige un moyen de mettre en pause, d’arrêter ou de masquer tout contenu en mouvement qui démarre automatiquement, dure plus de cinq secondes et s’affiche en parallèle d’autres contenus. Respecter prefers-reduced-motion ne satisfait pas le critère WCAG 2.2.2, car les utilisateurs qui n’ont jamais modifié le réglage de leur système d’exploitation voient toujours l’animation complète. Le document « Understanding » du W3C pour le critère 2.2.2 recommande en outre, si une page contient plusieurs éléments en mouvement, clignotants, défilants ou à mise à jour automatique, de fournir un mécanisme unique qui les contrôle tous.
| Critère | Niveau | Technique GSAP |
|---|---|---|
| 2.2.2 Mettre en pause, arrêter, masquer | A | Bouton de pause appelant timeline.pause() / timeline.play() |
| 2.3.3 Animation résultant d’interactions | AAA | Branche à mouvement réduit de gsap.matchMedia() |
Les critères WCAG 2.2.2 et 2.3.3 couvrent des mouvements différents. Le critère 2.3.3 s’applique aux mouvements déclenchés par une interaction de l’utilisateur, tandis que le critère 2.2.2 s’applique aux mouvements que la page lance d’elle-même. La présentation des animations accessibles d’OpenReplay aborde les recommandations de façon plus générale.
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);
});
pause() met l’instance en pause et peut, en option, la placer à un instant précis. Sans argument, elle s’arrête là où se trouve la tête de lecture. play() reprend la lecture à partir de ce point et garantit que l’instance n’est ni en pause ni inversée. Appelée sans argument, paused() fonctionne comme un getter : vous pouvez donc l’utiliser pour basculer entre les deux états.
gsap.matchMediaRefresh() annule toutes les configurations matchMedia actives et réexécute celles qui correspondent toujours. La case à cocher reconstruit ainsi immédiatement toutes les animations. La règle exprimée par reduce = isReduced || toggle.checked est la suivante : la bascule peut ajouter de la réduction, mais ne peut jamais outrepasser une demande de mouvement réduit émise par le système d’exploitation. La fonction de nettoyage se contente de retirer l’écouteur. N’y appelez pas context.revert(), car matchMedia gère lui-même l’annulation.
Garder le contenu visible si l’animation ne s’exécute jamais
Le contenu animé doit être parfaitement lisible dans son état CSS par défaut. Ainsi, si le script échoue ou si aucune branche matchMedia ne s’exécute, rien ne reste à opacity: 0 ou visibility: hidden. Ce cas se produit réellement : un handler gsap.matchMedia() reposant sur un objet de conditions ne s’exécute pas du tout lorsqu’aucune des conditions ne correspond.
/* 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() anime l’élément depuis les valeurs que vous transmettez jusqu’à son état actuel. L’état de repos reste donc visible, et seule l’animation masque l’élément, de façon temporaire. Il en va de même pour autoAlpha, la propriété GSAP qui combine opacité et visibilité : animez le contenu depuis autoAlpha: 0 au lieu de le masquer en CSS avec opacity: 0 et visibility: hidden en attendant qu’un tween le révèle.
Ordre de focus lorsque les éléments se déplacent
Les transformations GSAP telles que x, y et scale déplacent un élément visuellement, mais ne modifient pas sa position dans le DOM. Le focus clavier et l’ordre de lecture des lecteurs d’écran suivent donc le balisage, et non l’animation. Conservez un ordre de lecture logique dans le DOM et n’animez pas des propriétés de mise en page pour simuler un ordre différent.
Ne déplacez pas un élément pendant qu’il a le focus, et ne rendez pas un élément interactif cliquable avant qu’il soit stabilisé : un bouton qui glisse sous le curseur est une cible qui se dérobe. Pour le texte animé, SplitText prend en charge les lecteurs d’écran par défaut. Avec aria: "auto", il ajoute à l’élément découpé un aria-label rempli à partir de son texte, et ajoute aria-hidden aux éléments de ligne, de mot et de caractère qu’il contient. L’arbre d’accessibilité expose ainsi une seule chaîne lisible au lieu de fragments séparés. Ce comportement par défaut convient aux titres. En revanche, ARIA interdit aria-label sur les éléments génériques comme un simple <div>, <span> ou <p>, et les outils de vérification d’accessibilité le signalent dans ce cas. Pour ces éléments, ou si le texte découpé contient des liens imbriqués qui doivent être annoncés, utilisez aria: "none", qui n’ajoute aucun attribut ARIA, et fournissez une copie du texte réservée aux lecteurs d’écran.
Comment tester le mouvement réduit dans GSAP ?
Testez les deux branches de mouvement GSAP en basculant la préférence de mouvement réduit pendant que la page est ouverte. Comme gsap.matchMedia() réagit aux changements, les animations doivent s’échanger sans rechargement. Activez le réglage de réduction des animations du système d’exploitation (consultez la section de MDN sur les préférences utilisateur de prefers-reduced-motion pour savoir où il se trouve sur chaque plateforme), ou émulez-le dans Chrome. Dans les Chrome DevTools, ouvrez l’onglet Rendering, repérez « Emulate CSS media feature prefers-reduced-motion » et sélectionnez prefers-reduced-motion: reduce.
Vérifiez les points suivants :
- Les sections épinglées ne sont plus épinglées.
- Les mouvements en boucle ont disparu ou disposent d’un bouton de pause fonctionnel, accessible au clavier.
- Lorsque JavaScript est désactivé, tout le contenu reste visible.
- La bascule intégrée à la page reconstruit immédiatement les animations.
Conclusion
Une configuration GSAP accessible préserve le design tout en donnant aux utilisateurs le contrôle sur celui-ci. matchMedia remplace les grands mouvements par des fondus et reste synchronisé avec le réglage du système d’exploitation, ScrollTrigger cesse d’épingler dans la branche réduite, un véritable bouton met en pause tout ce qui dure longtemps, et le contenu reste visible sans JavaScript. Commencez par l’animation épinglée ou en boucle signalée par votre audit, écrivez sa branche réduite et sa commande de pause, puis testez les deux avec l’émulation des DevTools avant de passer à la suivante.
FAQ
Comment utiliser gsap.matchMedia() pour le mouvement réduit dans React ?
Créez l'instance matchMedia à l'intérieur de l'effet et renvoyez une fonction de nettoyage qui appelle mm.revert(). L'annulation de l'instance annule toutes les animations et tous les ScrollTriggers créés par ses handlers : un gsap.context() distinct est donc inutile. Le nettoyage est important en développement, car le Strict Mode de React monte, démonte puis remonte les composants, ce qui pourrait sinon lancer deux fois la même animation.
Une réinitialisation CSS basée sur prefers-reduced-motion arrête-t-elle les animations GSAP ?
Non. Une règle CSS globale qui raccourcit les durées d'animation et de transition dans un bloc prefers-reduced-motion: reduce n'affecte que les animations et transitions CSS. GSAP anime depuis JavaScript en écrivant des valeurs de style inline à chaque frame : ses tweens et ses ScrollTriggers continuent donc de s'exécuter. Gérez le mouvement GSAP avec une branche réduite de gsap.matchMedia(), et conservez la réinitialisation CSS pour les mouvements pilotés par CSS.
Que devient une animation GSAP en cours lorsque l'utilisateur modifie le réglage de mouvement réduit ?
gsap.matchMedia() l'annule et réexécute le handler pour la nouvelle préférence. L'annulation supprime les styles inline ajoutés par les animations et annule les ScrollTriggers créés dans le handler, y compris leur épinglage. La branche qui correspond désormais construit alors ses animations à partir de zéro : un tween à mouvement complet à moitié terminé ne reprend donc pas. La version réduite démarre depuis l'état CSS par défaut de l'élément.
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