Syntaxe
Les chaînes d'animation Glaze suivent un modèle simple :
[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 :
<div data-animate="from:opacity-0"></div>
to
Animez depuis l'état actuel vers ces valeurs :
<div data-animate="to:xPercent-50"></div>
fromTo
Utilisez les deux pour animer la transition entre deux états précis (fromTo dans GSAP) :
<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 (|) :
<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 :
<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 :
<div data-animate="to:xPercent-[-50]"></div>
Valeurs avec des espaces
Utilisez des underscores à la place des espaces :
<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 :
<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 :
<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 :
<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 :
<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. »