Syntax
Glaze-Animationsstrings folgen einem einfachen Muster:
[breakpoint][selector]:state:properties
Sehen wir uns die einzelnen Teile an.
Zustände
Jede Animation braucht einen Zustand: from, to oder beide.
from
Beginne mit diesen Werten und animiere zum natürlichen Zustand des Elements:
<div data-animate="from:opacity-0"></div>
to
Amiere vom aktuellen Zustand zu diesen Werten:
<div data-animate="to:xPercent-50"></div>
fromTo
Verwende beides, um zwischen zwei bestimmten Zuständen zu animieren (fromTo in GSAP):
<div data-animate="from:opacity-0.5 to:opacity-1"></div>
Eigenschaften
Führe nach dem Zustand deine Animationseigenschaften, durch senkrechte Striche (|) getrennt, auf:
<div data-animate="to:opacity-1|yPercent-10|duration-0.5"></div>
Der String wird analysiert, indem er am Bindestrich (-) geteilt wird. Der erste Teil ist der Eigenschaftsname, der zweite ihr Wert. Werte werden automatisch in den passenden Typ umgewandelt (Zahl, Boolean oder String).
Verschachtelte Eigenschaften
Verwende Punkte für verschachtelte Werte:
<div data-animate="to:scale.x-2|scale.y-2"></div>
Dadurch wird { scale: { x: 2, y: 2 } } erstellt.
Negative Werte
Setze negative Werte in Klammern:
<div data-animate="to:xPercent-[-50]"></div>
Werte mit Leerzeichen
Verwende Unterstriche statt Leerzeichen:
<div data-animate="to:boxShadow-[0_0_50px_20px_red]"></div>
Breakpoints
Füge @breakpoint: am Anfang ein, damit die Animation nur bei bestimmten Bildschirmgrößen ausgeführt wird:
<div data-animate="@sm:from:opacity-0"></div>
Dadurch wird nur auf Bildschirmen animiert, die zu deinem Breakpoint sm passen.
Selektoren
Ziele mit Klammernotation auf untergeordnete Elemente statt auf das Element selbst:
<div data-animate="[&>h1]:to:opacity-1|stagger-0.25">
<h1>One</h1>
<h1>Two</h1>
<h1>Three</h1>
</div>
& verweist auf das übergeordnete Element, daher bedeutet [&>h1] „alle untergeordneten h1-Elemente“.
Du kannst Selektoren mit Breakpoints kombinieren:
<div data-animate="@sm:[&>h1]:to:opacity-1|stagger-0.25">
<h1>...</h1>
<h1>...</h1>
<h1>...</h1>
</div>
Alles zusammenführen
Hier ist ein komplexes Beispiel:
<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>
Das bedeutet: „Auf großen Bildschirmen werden alle untergeordneten div-Elemente mit einem Stagger von Deckkraft 0 und y 50 animiert.“