본문으로 건너뛰기

기본값

엔진 구성과 동일한 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 애니메이션에는 공통 지속 시간과 to 이징이 적용되지만 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 전용 설정을 명시적으로 거부합니다.