Zum Inhalt springen

Standardwerte

Lege Standardwerte einmal im selben Aufruf von glaze() wie die Engine-Konfiguration fest. Die eigenen Utilities eines Elements überschreiben passende Standardwerte.

Element-Standardwerte

Unqualifizierte Eigenschaften gelten für jeden vorhandenen Animationszustand from oder 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>

Zustandsspezifische Standardwerte gelten nur für diesen Zustand:

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

Eine to-Animation erhält die gemeinsame Dauer und das to-Easing, aber es wird kein Zustand from hinzugefügt. Standardwerte erzeugen niemals einen Animationszustand, den das Element nicht angefordert hat. Bei einer from/to-Animation gelten gemeinsame Standardwerte für beide Zustände, danach zustandsspezifische Standardwerte und zuletzt die expliziten Werte des Elements.

Der ältere Konfigurationsschlüssel elementSettings bleibt ein Alias für gemeinsame Standardwerte. Verwende in neuem Code vorzugsweise element; wenn beide denselben Wert festlegen, hat element Vorrang.

Timeline-Standardwerte

Verwende defaults.tl für Einstellungen, die für jede Timeline gelten:

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

Glaze erstellt auch für eigenständige animierte Elemente eine Timeline. Werte unter defaults: werden als Standardwerte der Timeline an die Engine übergeben. Eigenschaften des Elements haben weiterhin Vorrang. Die eigenen Einstellungen einer Timeline überschreiben konfigurierte Werte, während nicht ersetzte Standardwerte erhalten bleiben.

Einstellungen für Timelines verwenden bei verschachtelten Eigenschaften einen Doppelpunkt:

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

Hier wird [&] zum Element aufgelöst, dem die Timeline gehört. ScrollTrigger erfordert GSAP und ein registriertes ScrollTrigger-Plugin. Der Motion-Adapter weist Einstellungen zurück, die nur für GSAP gelten.