Zum Inhalt springen

Syntax

Glaze-Animationsstrings folgen einem einfachen Muster:

Code
[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:

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

to

Amiere vom aktuellen Zustand zu diesen Werten:

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

fromTo

Verwende beides, um zwischen zwei bestimmten Zuständen zu animieren (fromTo in GSAP):

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

Eigenschaften

Führe nach dem Zustand deine Animationseigenschaften, durch senkrechte Striche (|) getrennt, auf:

HTML
<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:

HTML
<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:

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

Werte mit Leerzeichen

Verwende Unterstriche statt Leerzeichen:

HTML
<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:

HTML
<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:

HTML
<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:

HTML
<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:

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>

Das bedeutet: „Auf großen Bildschirmen werden alle untergeordneten div-Elemente mit einem Stagger von Deckkraft 0 und y 50 animiert.“