Sintassi
Le stringhe di animazione di Glaze seguono uno schema semplice:
[breakpoint][selector]:state:properties
Vediamo nel dettaglio i vari elementi.
Stati
Ogni animazione richiede uno stato: from, to o entrambi.
from
Partite da questi valori e animate fino allo stato naturale dell’elemento:
<div data-animate="from:opacity-0"></div>
to
Animate dallo stato attuale a questi valori:
<div data-animate="to:xPercent-50"></div>
fromTo
Usateli entrambi per animare tra due stati specifici (fromTo in GSAP):
<div data-animate="from:opacity-0.5 to:opacity-1"></div>
Proprietà
Dopo lo stato, elencate le proprietà dell’animazione, separate da barre verticali (|):
<div data-animate="to:opacity-1|yPercent-10|duration-0.5"></div>
La stringa viene analizzata dividendola in corrispondenza del trattino (-): la prima parte è il nome della proprietà e la seconda il suo valore. I valori vengono convertiti automaticamente nel tipo corretto (numero, booleano o stringa).
Proprietà annidate
Usate i punti per i valori annidati:
<div data-animate="to:scale.x-2|scale.y-2"></div>
Questo crea { scale: { x: 2, y: 2 } }.
Valori negativi
Racchiudete i valori negativi tra parentesi:
<div data-animate="to:xPercent-[-50]"></div>
Valori con spazi
Usate i trattini bassi al posto degli spazi:
<div data-animate="to:boxShadow-[0_0_50px_20px_red]"></div>
Punti di interruzione
Aggiungete @breakpoint: all'inizio per eseguire l'animazione solo a determinate dimensioni dello schermo:
<div data-animate="@sm:from:opacity-0"></div>
L'animazione viene eseguita solo sugli schermi che corrispondono al vostro punto di interruzione sm.
Selettori
Usate la notazione tra parentesi quadre per selezionare gli elementi figli anziché l'elemento stesso:
<div data-animate="[&>h1]:to:opacity-1|stagger-0.25">
<h1>One</h1>
<h1>Two</h1>
<h1>Three</h1>
</div>
& fa riferimento all'elemento genitore, quindi [&>h1] significa «tutti gli elementi h1 figli».
Potete combinare i selettori con i punti di interruzione:
<div data-animate="@sm:[&>h1]:to:opacity-1|stagger-0.25">
<h1>...</h1>
<h1>...</h1>
<h1>...</h1>
</div>
Mettere tutto insieme
Ecco un esempio complesso:
<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>
Significa: «Sugli schermi grandi, anima tutti gli elementi div figli partendo da opacità 0 e y 50, con un intervallo tra un'animazione e l'altra».