Sintaxis
Las cadenas de animación Glaze siguen un patrón sencillo:
[breakpoint][selector]:state:properties
Veámoslo paso a paso.
Estados
Toda animación necesita un estado: from, to o ambos.
from
Parte de estos valores y anima el elemento hasta su estado natural:
<div data-animate="from:opacity-0"></div>
to
Anima el elemento desde su estado actual hasta estos valores:
<div data-animate="to:xPercent-50"></div>
fromTo
Use ambos para animar entre dos estados específicos (fromTo en GSAP):
<div data-animate="from:opacity-0.5 to:opacity-1"></div>
Propiedades
Después del estado, enumera las propiedades de animación separadas por barras verticales (|):
<div data-animate="to:opacity-1|yPercent-10|duration-0.5"></div>
La cadena se analiza dividiéndola por el guion (-): la primera parte es el nombre de la propiedad y la segunda, su valor. Los valores se convierten automáticamente al tipo adecuado (número, booleano o cadena).
Propiedades anidadas
Usa puntos para los valores anidados:
<div data-animate="to:scale.x-2|scale.y-2"></div>
Esto crea { scale: { x: 2, y: 2 } }.
Valores negativos
Encierra los valores negativos entre corchetes:
<div data-animate="to:xPercent-[-50]"></div>
Valores con espacios
Usa guiones bajos en lugar de espacios:
<div data-animate="to:boxShadow-[0_0_50px_20px_red]"></div>
Puntos de ruptura
Añade @breakpoint: al principio para que la animación solo se ejecute en determinados tamaños de pantalla:
<div data-animate="@sm:from:opacity-0"></div>
La animación solo se ejecuta en pantallas que coinciden con tu punto de ruptura sm.
Selectores
Usa la notación con corchetes para seleccionar elementos secundarios en lugar del propio elemento:
<div data-animate="[&>h1]:to:opacity-1|stagger-0.25">
<h1>One</h1>
<h1>Two</h1>
<h1>Three</h1>
</div>
& hace referencia al elemento principal, así que [&>h1] significa «todos los elementos h1 secundarios».
Puedes combinar selectores con puntos de ruptura:
<div data-animate="@sm:[&>h1]:to:opacity-1|stagger-0.25">
<h1>...</h1>
<h1>...</h1>
<h1>...</h1>
</div>
Cómo combinarlo todo
Aquí tienes un ejemplo complejo:
<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>
Esto se lee así: «En pantallas grandes, anima todos los elementos div secundarios desde una opacidad de 0 y una posición y de 50, con retraso escalonado».