Aller au contenu

Valeurs par défaut

Appliquez les valeurs par défaut une seule fois, dans le même appel glaze() que la configuration du moteur. Les utilitaires propres à un élément remplacent les valeurs par défaut correspondantes.

Valeurs par défaut des éléments

Les propriétés seules s'appliquent à chaque état d'animation existant from ou to :

TypeScript
glaze({
  lib: { gsap: { core: gsap } },
  defaults: { element: "duration-1|ease-power2.inOut" },
})
HTML
<!-- Uses a one-second duration and the default easing. -->
<div data-animate="from:opacity-0"></div>

<!-- Explicit values win over defaults. -->
<div data-animate="from:opacity-0|duration-0.5"></div>

Les valeurs par défaut propres à un état ne s'appliquent qu'à cet état :

TypeScript
defaults: {
  element: "duration-1 from:opacity-0 to:ease-linear",
}

Une animation to reçoit la durée commune et l'accélération to, mais aucun état from n'est ajouté. Les valeurs par défaut ne créent jamais un état d'animation que l'élément n'a pas demandé. Pour une animation from/to, les valeurs par défaut communes s'appliquent aux deux états, puis les valeurs par défaut propres à chaque état, puis les valeurs explicites de l'élément.

L'ancienne clé de configuration elementSettings reste un alias des valeurs par défaut communes. Préférez element dans le nouveau code ; element prévaut lorsque les deux définissent la même valeur.

Valeurs par défaut des timelines

Utilisez defaults.tl pour les paramètres de chaque timeline :

TypeScript
glaze({
  lib: { gsap: { core: gsap } },
  defaults: {
    tl: "defaults:ease-power2.inOut|duration-1",
  },
})

Glaze crée une timeline même pour les éléments animés autonomes. Les valeurs sous defaults: sont transmises aux valeurs par défaut de timeline du moteur. Les propriétés de l'élément restent prioritaires. Les paramètres propres à une timeline remplacent les valeurs configurées tout en conservant les valeurs par défaut qu'ils ne remplacent pas.

Les paramètres de timeline utilisent deux-points pour les propriétés imbriquées :

TypeScript
defaults: {
  tl: "defaults:duration-1 scrollTrigger:trigger-[&]",
}

Ici, [&] désigne l'élément auquel appartient la timeline. ScrollTrigger nécessite GSAP et un plugin enregistré ScrollTrigger. L'adaptateur Motion rejette explicitement les paramètres propres à GSAP.