コンテンツへスキップ

デフォルト設定

エンジンの設定と同じglaze()呼び出しで、デフォルト値を一度だけ適用します。要素独自のユーティリティは、対応するデフォルト値を上書きします。

要素のデフォルト値

プロパティを単独で指定すると、既存のfromまたは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>

状態ごとのデフォルト値は、その状態にのみ適用されます。

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

toアニメーションには共通のdurationとtoeasingが適用されますが、from状態は追加されません。デフォルト値によって、要素が要求していないアニメーション状態が作成されることはありません。from/toアニメーションでは、共通のデフォルト値、状態ごとのデフォルト値、要素で明示した値の順に適用されます。

以前の設定キーelementSettingsは、引き続き共通デフォルト値の別名として使用できます。新しいコードではelementを優先してください。両方で同じ値が指定されている場合は、elementが優先されます。

タイムラインのデフォルト値

すべてのタイムラインに設定を適用するには、defaults.tlを使用します。

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

Glazeは、単独でアニメーションする要素に対してもタイムラインを作成します。defaults:の値は、エンジンのタイムラインデフォルト値として渡されます。要素のプロパティが引き続き優先されます。タイムライン独自の設定は、置き換えないデフォルト値を保持しながら、設定済みの値を上書きします。

タイムラインの設定では、ネストしたプロパティにコロンを使用します。

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

ここで[&]はタイムラインを所有する要素を参照します。ScrollTriggerには、GSAPと登録済みのScrollTriggerプラグインが必要です。MotionアダプターはGSAPのみの設定を明示的に拒否します。