선택자
기본적으로 Glaze은 data-animate 속성이 있는 요소를 검색하고 해당 속성 값에 따라 애니메이션을 구성합니다. 이 페이지에서는 Glaze이 읽는 요소를 변경하는 세 가지 옵션인 dataAttribute, className, element과 애니메이션을 다른 요소에 연결하는 대괄호 선택자를 다룹니다. 문자열 안의 유틸리티는 구문에서 설명합니다.
요소를 찾는 방법
glaze()이 실행될 때와 refresh() 또는 감시 모드 재빌드가 발생할 때마다 루트 내부의 모든 요소를 순회하며, 설정된 속성이 있거나 클래스 모드에서 설정된 접두사가 붙은 클래스가 있는 요소를 선택합니다. 루트 요소 자체에 해당 항목이 있으면 루트도 포함됩니다. 요소는 문서 순서대로 읽습니다.
이 방식으로 찾은 각 요소는 자체 타임라인을 가집니다. 단, tl 요소 안에 있거나 tl:<id>로 해당 요소에 연결된 경우는 예외입니다. 이 경우에는 해당 타임라인에 추가됩니다. 그룹화 방식은 타임라인을 참조하세요.
사용자 지정 속성
다른 데이터 속성을 사용하세요.
glaze({
lib: { gsap: { core: gsap } },
dataAttribute: "data-move",
})
이제 Glaze은 data-animate 대신 data-move을 찾습니다.
<div data-move="from:opacity-0"></div>
이 옵션은 속성을 추가하는 대신 대체합니다. 위 설정을 사용하면 여전히 data-animate을 가진 요소는 무시됩니다. 페이지의 다른 스크립트가 이미 data-animate을 읽거나, 마크업에서 프로젝트에 맞는 속성 이름을 사용하려는 경우 이 옵션을 사용하세요.
감시 모드에서는 Glaze가 설정된 속성을 감시하므로 요소의 data-move 값이 바뀌면 다시 빌드합니다.
클래스 기반 구문
데이터 속성보다 클래스를 선호하시나요? 클래스 모드를 활성화하세요.
glaze({
lib: { gsap: { core: gsap } },
className: "animate",
})
이제 애니메이션을 클래스로 작성할 수 있습니다.
<div class="animate-from:opacity-0|duration-1"></div>
유틸리티 우선 방식의 CSS을 이미 사용하고 있고 애니메이션도 비슷한 느낌으로 만들고 싶다면 이 방식이 잘 맞습니다. 템플릿 시스템에서 요소에 클래스를 추가할 수는 있지만 임의의 속성은 추가할 수 없는 경우에도 클래스 모드가 유용합니다.
Glaze은 접두사 뒤에 대시가 오는 모든 클래스(여기서는 animate-)를 읽고 해당 부분을 제거합니다. 접두사가 없는 클래스는 그대로 두므로 같은 요소에서 애니메이션 클래스와 스타일 클래스가 함께 사용될 수 있습니다. 애니메이션을 여러 클래스로 나눌 수도 있습니다:
<div class="card animate-from:opacity-0 animate-from:y-24"></div>
반응형 클래스에서는 중단점을 접두사 앞이나 뒤에 둘 수 있습니다. 두 방식 모두 lg 중단점이 일치할 때만 실행됩니다:
<div class="animate-@lg:from:opacity-0"></div>
<div class="@lg:animate-from:opacity-0"></div>
클래스에서도 프리셋은 같은 방식으로 작동합니다. 예를 들면 animate-preset-fadeIn입니다.
클래스 모드를 사용해도 데이터 속성은 비활성화되지 않습니다. 요소에 둘 다 있으면 Glaze은 하나의 문자열로 합칩니다. 먼저 속성 값이 오고, 그다음 class 속성에 나타난 순서대로 접두사가 붙은 클래스가 옵니다.
<div
class="animate-from:opacity-0 animate-@lg:from:y-50"
data-animate="from:duration-1"
></div>
이 요소는 모든 화면 크기에서 opacity: 0에서 시작해 1초 동안 애니메이션되고, lg이 일치하면 y: 50에서도 애니메이션됩니다. 문자열이 합쳐지므로 하나의 문자열 안에서와 같은 규칙이 적용됩니다. 두 부분이 같은 속성을 설정하면 뒤에 오는 값이 우선합니다. 여기서는 클래스 값이 속성 값을 덮어써 x에 적용됩니다:
<div class="animate-to:x-100" data-animate="to:x-50|y-20"></div>
요소가 x: 100 및 y: 20 상태로 애니메이션됩니다.
클래스 모드에서 watch을 활성화하면 Glaze도 class의 변경 사항을 감지합니다. 요소에 animate- 클래스를 추가하거나, Glaze 이미 읽거나 애니메이션을 적용 중인 요소의 클래스를 변경하면 재빌드가 예약됩니다. 상대 선택자가 있는 요소 내부에서는 하위 요소의 클래스 변경도 재빌드를 예약합니다. 선택자와 일치하는 항목이 달라질 수 있기 때문입니다. 다른 요소의 클래스 변경은 재빌드를 유발하지 않습니다. 여기에는 애니메이션이 적용되는 요소의 상위 요소도 포함되므로, <html>의 다크 모드 클래스나 <body>의 스크롤 잠금 클래스를 전환해도 실행 중인 애니메이션에는 영향이 없습니다. 클래스 변경으로 요소가 전역 선택자와 새롭게 일치하게 되는 경우도 감지되지 않으므로, 그 뒤에 refresh()을 호출하세요.
검색 범위 제한
Glaze은 기본적으로 전체 document을 검색합니다. 컨테이너 안의 요소만 애니메이션하려면 element을 전달하세요:
glaze({
lib: { gsap: { core: gsap } },
element: document.querySelector("#app"),
})
element은 Element 또는 Document을 받습니다. 다음 세 가지를 제한합니다:
- 애니메이션 유틸리티를 찾기 위해 루트와 그 자손만 검색합니다. 페이지의 다른 요소는
data-animate을 가지고 있어도 무시됩니다. - 감시 모드는 루트 내부의 변경만 감시합니다.
destroy()은 이 인스턴스가 만든 항목만 정리하므로 페이지의 다른 부분에 있는 애니메이션은 유지됩니다.
따라서 컴포넌트 프레임워크에서는 element을 사용하는 것이 좋습니다. 마운트된 컴포넌트마다 루트 요소를 사용해 인스턴스를 하나 만들고, 컴포넌트가 언마운트될 때 destroy()을 호출하세요. 자세한 내용은 새로고침 및 정리를 참조하세요. 서로 겹치지 않는 루트를 각 인스턴스에 지정하세요. 두 루트 안에 모두 포함된 요소는 두 인스턴스에서 모두 애니메이션됩니다.
다른 요소 지정하기
위 옵션은 Glaze이 읽는 요소를 결정합니다. 세그먼트 시작 부분에 대괄호 선택자를 두면 애니메이션을 적용할 요소를 지정합니다. 선택자가 없으면 유틸리티를 가진 요소가 애니메이션 대상이 됩니다.
상대 선택자
&으로 시작하는 선택자는 요소 자체를 기준으로 해석되며, &은 해당 요소를 나타냅니다. querySelectorAll로 조회하므로 여러 요소와 일치할 수 있습니다:
<ul data-animate="[&>li]:from:opacity-0|y-20|stagger-0.1">
<li>One</li>
<li>Two</li>
<li>Three</li>
</ul>
[&>li]은 바로 아래의 li 자식 요소와 일치합니다. stagger 값은 시작 시간을 0.1초 간격으로 배치합니다. 각 자식 요소에 속성을 추가하지 않고 하나의 요소로 목록, 그리드 또는 자식 그룹의 애니메이션을 제어하려면 이 방식을 사용하세요.
공백은 밑줄로 표시합니다. [&_p]은 & p이 되며 요소 안의 모든 깊이에 있는 각 p와 일치합니다:
<article data-animate="[&_p]:from:opacity-0|stagger-0.2">
<p>First paragraph</p>
<div><p>Nested paragraph</p></div>
</article>
선택자에 있는 모든 밑줄은 공백으로 바뀌므로 밑줄이 포함된 클래스 이름은 이 방식으로 찾을 수 없습니다.
[&]만 단독으로 사용하면 해당 요소 자체를 가리킵니다. 주로 값으로 사용됩니다.
예를 들어 scrollTrigger.trigger-[&]를 ScrollTrigger에서 사용하거나
타임라인 기본값에서 사용합니다.
전역 선택자
&이 없는 선택자는 문자열로 애니메이션 엔진에 전달됩니다. GSAP과 Motion은 모두 요소나 element 루트가 아니라 전체 문서에서 선택자를 찾습니다:
<h2 data-animate="[.badge]:from:opacity-0|scale-0.5|duration-0.3">Inbox</h2>
<span class="badge">3</span>
이 선택자는 페이지 어디에 있든 모든 .badge를 애니메이션합니다. 재사용 가능한 컴포넌트 안에서는 상대 선택자를 사용하는 것이 좋습니다. 전역 선택자는 페이지의 다른 위치에 있는 동일한 컴포넌트 복사본에도 일치하기 때문입니다.
제한 사항
각 요소에는 대상이 하나만 있습니다. 여러 세그먼트에 선택자가 있으면 마지막 선택자가 요소의 모든 상태에 적용됩니다. 여기서는 from과 to이 h1이 아니라 p에 적용됩니다:
<div data-animate="[&>h1]:from:opacity-0 [&>p]:to:x-20">
<h1>Title</h1>
<p>Text</p>
</div>
두 그룹을 다르게 애니메이션하려면 유틸리티를 자식 요소에 직접 넣거나 타임라인으로 그룹화하세요.
선택자는 첫 번째 ]에서 끝나므로 [&>[data-item]] 같은 속성 선택자처럼 대괄호가 포함된 선택자는 지원되지 않습니다. 대신 클래스 선택자나 요소 선택자를 사용하세요.
선택자는 문법에 설명된 순서대로 중단점과 결합됩니다. 예를 들면 @lg:[&>div]:from:opacity-0입니다.