Aller au contenu

Syntaxe

Les chaînes d'animation Glaze suivent un modèle simple :

Code
[breakpoint][selector]:state:properties

Voyons cela en détail.

États

Chaque animation doit avoir un état : from, to ou les deux.

from

Partez de ces valeurs, puis animez l'élément jusqu'à son état naturel :

HTML
<div data-animate="from:opacity-0"></div>

to

Animez depuis l'état actuel vers ces valeurs :

HTML
<div data-animate="to:xPercent-50"></div>

fromTo

Utilisez les deux pour animer la transition entre deux états précis (fromTo dans GSAP) :

HTML
<div data-animate="from:opacity-0.5 to:opacity-1"></div>

Propriétés

Après l'état, indiquez vos propriétés d'animation en les séparant par des barres verticales (|) :

HTML
<div data-animate="to:opacity-1|yPercent-10|duration-0.5"></div>

La chaîne est analysée en la séparant au tiret (-) : la première partie correspond au nom de la propriété et la seconde à sa valeur. Les valeurs sont automatiquement converties dans le type approprié (nombre, booléen ou chaîne).

Propriétés imbriquées

Utilisez des points pour les valeurs imbriquées :

HTML
<div data-animate="to:scale.x-2|scale.y-2"></div>

Cela crée { scale: { x: 2, y: 2 } }.

Valeurs négatives

Encadrez les valeurs négatives entre crochets :

HTML
<div data-animate="to:xPercent-[-50]"></div>

Valeurs avec des espaces

Utilisez des underscores à la place des espaces :

HTML
<div data-animate="to:boxShadow-[0_0_50px_20px_red]"></div>

Points de rupture

Ajoutez @breakpoint: au début pour exécuter l’animation uniquement à certaines tailles d’écran :

HTML
<div data-animate="@sm:from:opacity-0"></div>

L’animation s’exécute uniquement sur les écrans correspondant à votre point de rupture sm.

Sélecteurs

Ciblez les éléments enfants plutôt que l’élément lui-même en utilisant la notation entre crochets :

HTML
<div data-animate="[&>h1]:to:opacity-1|stagger-0.25">
  <h1>One</h1>
  <h1>Two</h1>
  <h1>Three</h1>
</div>

& désigne l’élément parent ; [&>h1] signifie donc « tous les éléments h1 enfants ».

Vous pouvez combiner les sélecteurs avec les points de rupture :

HTML
<div data-animate="@sm:[&>h1]:to:opacity-1|stagger-0.25">
  <h1>...</h1>
  <h1>...</h1>
  <h1>...</h1>
</div>

Pour tout combiner

Voici un exemple complexe :

HTML
<div
  data-animate="@lg:[&>div]:from:opacity-0|y-50|stagger-0.1|duration-0.5|ease-power2.out"
>
  <div>Card 1</div>
  <div>Card 2</div>
  <div>Card 3</div>
</div>

Cela signifie : « Sur les grands écrans, animez tous les éléments div enfants à partir d’une opacité de 0 et d’une position y de 50, avec un décalage progressif. »