Selektory
Domyślnie Glaze wyszukuje elementy z atrybutem data-animate i tworzy animację na podstawie wartości tego atrybutu. Ta strona opisuje trzy opcje zmieniające to, które elementy odczytuje Glaze: dataAttribute, className i element, oraz selektory nawiasowe wskazujące inne elementy jako cel animacji. Narzędzia dostępne w ciągu opisano w sekcji Składnia.
Jak wyszukiwane są elementy
Po uruchomieniu glaze(), a następnie ponownie przy każdym refresh() lub przebudowie w trybie obserwowania, przechodzi po wszystkich elementach wewnątrz elementu głównego i wybiera te, które mają skonfigurowany atrybut albo — w trybie klas — klasę z skonfigurowanym prefiksem. Element główny również jest uwzględniany, jeśli ma taki atrybut lub klasę. Elementy są odczytywane w kolejności dokumentu.
Każdy znaleziony w ten sposób element otrzymuje własną oś czasu, chyba że znajduje się wewnątrz elementu tl lub jest z nim powiązany za pomocą tl:<id>. W takim przypadku zostaje dodany do tej osi czasu. Zobacz Osie czasu, aby dowiedzieć się, jak działa grupowanie.
Własny atrybut
Użyj innego atrybutu danych:
glaze({
lib: { gsap: { core: gsap } },
dataAttribute: "data-move",
})
Teraz Glaze będzie szukać data-move zamiast data-animate:
<div data-move="from:opacity-0"></div>
Ta opcja zastępuje atrybut, zamiast dodawać nowy. Przy powyższym ustawieniu element, który nadal ma data-animate, jest pomijany. Użyj tej opcji, gdy inny skrypt na stronie odczytuje już data-animate albo gdy chcesz, aby znacznik używał nazwy atrybutu związanej z Twoim projektem.
W trybie obserwowania Glaze obserwuje skonfigurowany atrybut, więc zmiana wartości data-move elementu powoduje zaplanowanie przebudowy.
Składnia oparta na klasach
Wolisz klasy zamiast atrybutów danych? Włącz tryb klas:
glaze({
lib: { gsap: { core: gsap } },
className: "animate",
})
Teraz możesz zapisywać animacje jako klasy:
<div class="animate-from:opacity-0|duration-1"></div>
Sprawdza się to, jeśli używasz już CSS w podejściu utility-first i chcesz, aby animacje miały podobny charakter. Tryb klas jest też przydatny, gdy system szablonów pozwala dodawać klasy do elementu, ale nie dowolne atrybuty.
Glaze odczytuje każdą klasę zaczynającą się od prefiksu, po którym następuje myślnik (tutaj animate-), i usuwa tę część. Klasy bez prefiksu pozostają bez zmian, więc klasy animacji mogą występować obok klas stylizujących na tym samym elemencie. Animację można rozdzielić na kilka klas:
<div class="card animate-from:opacity-0 animate-from:y-24"></div>
Klasy responsywne przyjmują punkt przerwania zarówno po prefiksie, jak i przed nim. Obie te formy działają tylko wtedy, gdy pasuje lg punkt przerwania:
<div class="animate-@lg:from:opacity-0"></div>
<div class="@lg:animate-from:opacity-0"></div>
Gotowe konfiguracje działają w klasach tak samo, na przykład animate-preset-fadeIn.
Tryb klas nie wyłącza atrybutu danych. Gdy element ma oba, Glaze łączy je w jeden ciąg: najpierw wartość atrybutu, a potem prefiksowane klasy w kolejności występowania w atrybucie class.
<div
class="animate-from:opacity-0 animate-@lg:from:y-50"
data-animate="from:duration-1"
></div>
Ten element animuje się od opacity: 0 przez jedną sekundę przy każdym rozmiarze, a także od y: 50, gdy pasuje lg. Ponieważ ciągi są łączone, obowiązuje ta sama zasada co w pojedynczym ciągu: gdy dwie części ustawiają tę samą właściwość, wygrywa późniejsza. Tutaj wartość klasy zastępuje wartość atrybutu dla x:
<div class="animate-to:x-100" data-animate="to:x-50|y-20"></div>
Element animuje się do x: 100 i y: 20.
Gdy watch jest włączone w trybie klas, Glaze obserwuje również zmiany class. Dodanie klasy animate- do elementu lub zmiana klas elementu, który Glaze już odczytuje albo animuje, powoduje zaplanowanie przebudowy. Zmiany klas elementów potomnych również ją powodują, jeśli dany element ma selektor względny, ponieważ mogą zmienić dopasowanie selektora. Zmiany klas innych elementów nie powodują przebudowy. Dotyczy to także przodków animowanych elementów, więc przełączenie klasy trybu ciemnego na <html> lub klasy blokady przewijania na <body> nie przerywa trwających animacji. Zmiana klasy, która sprawia, że element zaczyna pasować do selektora globalnego, również nie zostanie wykryta; wywołaj refresh() po jej wprowadzeniu.
Ograniczanie wyszukiwania
Glaze domyślnie przeszukuje cały document. Przekaż element, aby animować tylko elementy wewnątrz kontenera:
glaze({
lib: { gsap: { core: gsap } },
element: document.querySelector("#app"),
})
element przyjmuje Element lub Document. Ogranicza trzy rzeczy:
- Tylko element główny i jego elementy potomne są skanowane w poszukiwaniu narzędzi animacji. Elementy w innych miejscach strony są pomijane, nawet jeśli mają
data-animate. - Tryb obserwowania śledzi zmiany tylko wewnątrz elementu głównego.
destroy()usuwa tylko to, co utworzyła ta instancja, dzięki czemu animacje w innych częściach strony pozostają nienaruszone.
Dlatego element warto stosować w frameworkach komponentowych. Utwórz jedną instancję dla każdego zamontowanego komponentu, używając jego elementu głównego, i wywołaj destroy() podczas odmontowywania, jak pokazano w sekcji Odświeżanie i czyszczenie. Przypisz osobnym instancjom niepokrywające się elementy główne; element znajdujący się wewnątrz dwóch takich elementów będzie animowany przez obie instancje.
Wybieranie innych elementów
Powyższe opcje określają, które elementy odczytuje Glaze. Selektor w nawiasach kwadratowych na początku segmentu określa, do których elementów stosowana jest animacja. Jeśli go nie podano, animacja dotyczy elementu zawierającego te narzędzia.
Selektory względne
Selektor zaczynający się od & jest rozwiązywany względem samego elementu, a & oznacza ten element. Selektor jest wyszukiwany za pomocą querySelectorAll, więc może pasować do wielu elementów:
<ul data-animate="[&>li]:from:opacity-0|y-20|stagger-0.1">
<li>One</li>
<li>Two</li>
<li>Three</li>
</ul>
[&>li] pasuje do bezpośrednich elementów potomnych li. Wartość stagger rozdziela ich czasy rozpoczęcia o 0.1 sekundy. Użyj tego, gdy jeden element ma sterować animacją listy, siatki lub grupy elementów potomnych bez dodawania atrybutu do każdego z nich.
Zapisuj spacje jako podkreślenia. [&_p] zmienia się w & p i pasuje do każdego p wewnątrz elementu, na dowolnym poziomie zagnieżdżenia:
<article data-animate="[&_p]:from:opacity-0|stagger-0.2">
<p>First paragraph</p>
<div><p>Nested paragraph</p></div>
</article>
Każde podkreślenie w selektorze jest zamieniane na spację, więc nie można w ten sposób dopasować nazwy klasy zawierającej podkreślenie.
[&] użyte samodzielnie wskazuje sam element. Jest stosowane głównie jako wartość, na przykład scrollTrigger.trigger-[&] w ScrollTrigger oraz w ustawieniach domyślnych osi czasu.
Selektory globalne
Selektor bez & jest przekazywany do silnika animacji jako ciąg. GSAP i Motion rozpatrują go względem całego dokumentu, a nie elementu ani elementu głównego element:
<h2 data-animate="[.badge]:from:opacity-0|scale-0.5|duration-0.3">Inbox</h2>
<span class="badge">3</span>
Animuje to każdy .badge na stronie, niezależnie od jego położenia. W komponentach wielokrotnego użytku preferuj selektory względne, ponieważ selektor globalny pasuje również do kopii komponentu w innych miejscach strony.
Ograniczenia
Każdy element ma jeden cel. Gdy kilka segmentów zawiera selektor, ostatni z nich ma zastosowanie do wszystkich stanów elementu. Tutaj zarówno from, jak i to są stosowane do p, a nie do h1:
<div data-animate="[&>h1]:from:opacity-0 [&>p]:to:x-20">
<h1>Title</h1>
<p>Text</p>
</div>
Aby animować dwie grupy w różny sposób, umieść narzędzia bezpośrednio na elementach potomnych albo zgrupuj je na osi czasu.
Selektor kończy się na pierwszym ], dlatego selektory zawierające nawiasy, takie jak selektory atrybutów [&>[data-item]], nie są obsługiwane. Zamiast nich użyj selektora klasy lub elementu.
Selektory łączą się z punktami przerwania w kolejności opisanej w sekcji Składnia, na przykład @lg:[&>div]:from:opacity-0.