Saltar al contenido

Valores predeterminados

Aplica los valores predeterminados una sola vez en la misma llamada a glaze() que la configuración del motor. Las utilidades propias de un elemento prevalecen sobre los valores predeterminados coincidentes.

Valores predeterminados de los elementos

Las propiedades sin estado específico se aplican a todos los estados de animación existentes from o to:

TypeScript
glaze({
  lib: { gsap: { core: gsap } },
  defaults: { element: "duration-1|ease-power2.inOut" },
})
HTML
<!-- Uses a one-second duration and the default easing. -->
<div data-animate="from:opacity-0"></div>

<!-- Explicit values win over defaults. -->
<div data-animate="from:opacity-0|duration-0.5"></div>

Los valores predeterminados específicos de un estado se aplican solo a ese estado:

TypeScript
defaults: {
  element: "duration-1 from:opacity-0 to:ease-linear",
}

Una animación to recibe la duración común y la aceleración to, pero no se añade ningún estado from. Los valores predeterminados nunca crean un estado de animación que el elemento no haya solicitado. En una animación from/to, los valores predeterminados comunes se aplican a ambos estados, seguidos de los valores predeterminados específicos de cada estado y, por último, de los valores explícitos del elemento.

La clave de configuración anterior elementSettings sigue siendo un alias para los valores predeterminados comunes. En el código nuevo, prefiere element; si ambas especifican el mismo valor, prevalece element.

Valores predeterminados de la línea de tiempo

Usa defaults.tl para configurar todas las líneas de tiempo:

TypeScript
glaze({
  lib: { gsap: { core: gsap } },
  defaults: {
    tl: "defaults:ease-power2.inOut|duration-1",
  },
})

Glaze crea una línea de tiempo incluso para elementos animados independientes. Los valores de defaults: se pasan a los valores predeterminados de la línea de tiempo del motor. Las propiedades del elemento siguen teniendo prioridad. La configuración propia de una línea de tiempo prevalece sobre los valores configurados y conserva los valores predeterminados que no reemplaza.

La configuración de la línea de tiempo usa dos puntos para las propiedades anidadas:

TypeScript
defaults: {
  tl: "defaults:duration-1 scrollTrigger:trigger-[&]",
}

Aquí, [&] hace referencia al elemento propietario de la línea de tiempo. ScrollTrigger requiere GSAP y un complemento registradoScrollTrigger. El adaptador Motion rechaza explícitamente la configuración exclusiva de GSAP.