Selectores
De forma predeterminada, Glaze busca elementos con el atributo data-animate y crea la animación según el valor de ese atributo. Esta página describe las tres opciones que cambian qué elementos lee Glaze: dataAttribute, className y element, así como los selectores entre corchetes que dirigen una animación a otros elementos. Las utilidades de la cadena se describen en Sintaxis.
Cómo se encuentran los elementos
Cuando se ejecuta glaze(), y de nuevo en cada reconstrucción de refresh() o del modo de observación, recorre todos los elementos dentro de la raíz y conserva los que tienen el atributo configurado o, en modo de clases, una clase con el prefijo configurado. El propio elemento raíz también se cuenta si tiene uno de esos atributos o clases. Los elementos se leen en el orden del documento.
Cada elemento encontrado de esta forma obtiene su propia línea de tiempo, salvo que esté dentro de un elemento tl o esté vinculado a uno mediante tl:<id>. En ese caso, se añade a esa línea de tiempo. Consulte Líneas de tiempo para saber cómo funciona la agrupación.
Atributo personalizado
Usa otro atributo de datos:
glaze({
lib: { gsap: { core: gsap } },
dataAttribute: "data-move",
})
Ahora Glaze buscará data-move en lugar de data-animate:
<div data-move="from:opacity-0"></div>
La opción reemplaza el atributo en lugar de añadir uno. Con la configuración anterior, se ignora un elemento que aún tenga data-animate. Úsela cuando otro script de la página ya lea data-animate o cuando quiera que el marcado use el nombre del atributo de su proyecto.
En el modo observación, Glaze observa el atributo configurado, por lo que cambiar el valor de data-move en un elemento programa una reconstrucción.
Sintaxis basada en clases
¿Prefieres usar clases en lugar de atributos de datos? Activa el modo de clases:
glaze({
lib: { gsap: { core: gsap } },
className: "animate",
})
Ahora puedes escribir animaciones como clases:
<div class="animate-from:opacity-0|duration-1"></div>
Esto funciona bien si ya usa CSS con un enfoque utility-first y quiere que sus animaciones tengan un estilo similar. El modo de clases también resulta útil cuando un sistema de plantillas permite añadir clases a un elemento, pero no atributos arbitrarios.
Glaze lee todas las clases que empiezan por el prefijo seguido de un guion (animate- aquí) y elimina esa parte. Las clases sin el prefijo se dejan intactas, de modo que las clases de animación pueden estar junto a las clases de estilo en el mismo elemento. Puede dividir una animación entre varias clases:
<div class="card animate-from:opacity-0 animate-from:y-24"></div>
Las clases adaptables aceptan el punto de interrupción después o antes del prefijo. Ambas se ejecutan solo cuando coincide el lg punto de interrupción:
<div class="animate-@lg:from:opacity-0"></div>
<div class="@lg:animate-from:opacity-0"></div>
Los Presets funcionan igual en las clases, por ejemplo animate-preset-fadeIn.
El modo de clases no desactiva el atributo de datos. Cuando un elemento tiene ambos, Glaze los combina en una sola cadena: primero el valor del atributo y después las clases con prefijo en el orden en que aparecen en el atributo class.
<div
class="animate-from:opacity-0 animate-@lg:from:y-50"
data-animate="from:duration-1"
></div>
Este elemento se anima desde opacity: 0 durante un segundo en todos los tamaños y también desde y: 50 cuando coincide lg. Como las cadenas se combinan, se aplica la misma regla que dentro de una sola cadena: si dos partes establecen la misma propiedad, prevalece la posterior. Aquí, el valor de la clase sobrescribe el valor del atributo para x:
<div class="animate-to:x-100" data-animate="to:x-50|y-20"></div>
El elemento se anima hasta x: 100 y y: 20.
Con watch activado en modo de clases, Glaze también observa los cambios de class. Añadir una clase animate- a un elemento o cambiar las clases de un elemento que Glaze ya lee o anima programa una reconstrucción. Dentro de un elemento con un selector relativo, los cambios de clase en sus descendientes también la programan, porque pueden cambiar los elementos que coinciden con el selector. Los cambios de clase en otros elementos no la programan, incluidos los ancestros de los elementos animados; por eso, activar una clase de modo oscuro en <html> o una clase de bloqueo de desplazamiento en <body> no afecta a las animaciones en curso. Tampoco se detecta un cambio de clase que haga que un elemento coincida por primera vez con un selector global; llama a refresh() después.
Limitar la búsqueda
Glaze busca en todo el document de forma predeterminada. Pase element para animar solo los elementos dentro de un contenedor:
glaze({
lib: { gsap: { core: gsap } },
element: document.querySelector("#app"),
})
element acepta un Element o un Document. Limita tres aspectos:
- Solo se exploran la raíz y sus descendientes en busca de utilidades de animación. Los elementos que están en otras partes de la página se ignoran, aunque tengan
data-animate. - El modo de observación solo detecta cambios dentro de la raíz.
destroy()limpia únicamente lo que creó esta instancia, para que las animaciones de otras partes de la página se conserven.
Esto convierte a element en la opción ideal para los marcos de componentes. Cree una instancia por cada componente montado con el elemento raíz del componente y llame a destroy() cuando se desmonte, como se muestra en Actualización y limpieza. Asigne raíces que no se solapen a las distintas instancias; si un elemento está dentro de dos raíces, ambas instancias lo animan.
Seleccionar otros elementos
Las opciones anteriores determinan qué elementos lee Glaze. Un selector entre corchetes al inicio de un segmento determina a qué elementos se aplica la animación. Si no hay ninguno, la animación se aplica al elemento que contiene las utilidades.
Selectores relativos
Un selector que empieza por & se resuelve desde el propio elemento; & representa ese elemento. Se consulta con querySelectorAll, por lo que puede coincidir con varios elementos:
<ul data-animate="[&>li]:from:opacity-0|y-20|stagger-0.1">
<li>One</li>
<li>Two</li>
<li>Three</li>
</ul>
[&>li] coincide con los elementos li secundarios directos. El valor stagger separa sus horas de inicio por 0.1 segundos. Úselo cuando un elemento deba controlar la animación de una lista, cuadrícula o grupo de elementos secundarios sin añadir un atributo a cada uno.
Escriba los espacios como guiones bajos. [&_p] se convierte en & p y coincide con todos los p dentro del elemento, a cualquier profundidad:
<article data-animate="[&_p]:from:opacity-0|stagger-0.2">
<p>First paragraph</p>
<div><p>Nested paragraph</p></div>
</article>
Cada guion bajo de un selector se convierte en un espacio, por lo que no se puede encontrar de esta forma un nombre de clase que contenga un guion bajo.
[&] por sí solo se resuelve en el propio elemento. Se usa sobre todo como valor, por ejemplo scrollTrigger.trigger-[&] en ScrollTrigger y en los valores predeterminados de la línea de tiempo.
Selectores globales
Un selector sin & se pasa al motor de animación como una cadena. Tanto GSAP como Motion lo resuelven respecto a todo el documento, no respecto al elemento ni a la raíz element:
<h2 data-animate="[.badge]:from:opacity-0|scale-0.5|duration-0.3">Inbox</h2>
<span class="badge">3</span>
Esto anima todos los .badge de la página, estén donde estén. Prefiera los selectores relativos dentro de los componentes reutilizables, porque un selector global también coincide con las copias del componente que haya en otras partes de la página.
Límites
Cada elemento tiene un destino. Cuando varios segmentos incluyen un selector, el último se aplica a todos los estados del elemento. Aquí, tanto from como to se aplican a p, no a h1:
<div data-animate="[&>h1]:from:opacity-0 [&>p]:to:x-20">
<h1>Title</h1>
<p>Text</p>
</div>
Para animar dos grupos de forma distinta, coloque las utilidades en los propios elementos secundarios o agrúpelos en una línea de tiempo.
Un selector termina en el primer ], por lo que no se admiten selectores que contengan corchetes, como los selectores de atributos [&>[data-item]]. En su lugar, use un selector de clase o de elemento.
Los selectores se combinan con los puntos de interrupción en el orden descrito en Sintaxis, por ejemplo @lg:[&>div]:from:opacity-0.