Saltar al contenido

Sintaxis

Las cadenas de animación Glaze siguen un patrón sencillo:

Código
[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:

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

to

Anima el elemento desde su estado actual hasta estos valores:

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

fromTo

Use ambos para animar entre dos estados específicos (fromTo en GSAP):

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

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

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

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

Valores con espacios

Usa guiones bajos en lugar de espacios:

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

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

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

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

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>

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».