Selectori
În mod implicit, Glaze caută elemente cu atributul data-animate și construiește animația pe baza valorii acelui atribut. Această pagină prezintă cele trei opțiuni care schimbă elementele citite de Glaze: dataAttribute și className și element, precum și selectorii între paranteze drepte care direcționează animația către alte elemente. Utilitarele din șir sunt descrise în Sintaxă.
Cum sunt găsite elementele
Când rulează glaze(), precum și la fiecare reconstruire refresh() sau în modul de monitorizare, parcurge toate elementele din rădăcină și le reține pe cele care au atributul configurat sau, în modul cu clase, o clasă cu prefixul configurat. Se ia în considerare și elementul rădăcină, dacă are atributul sau clasa respectivă. Elementele sunt citite în ordinea documentului.
Fiecare element găsit astfel primește propria cronologie, cu excepția cazului în care se află în interiorul unui element tl sau este asociat unuia prin tl:<id>. În acest caz, este adăugat la cronologia respectivă. Consultați Cronologii pentru a afla cum funcționează gruparea.
Atribut personalizat
Folosiți un alt atribut de date:
glaze({
lib: { gsap: { core: gsap } },
dataAttribute: "data-move",
})
Acum Glaze va căuta data-move în loc de data-animate:
<div data-move="from:opacity-0"></div>
Opțiunea înlocuiește atributul, în loc să adauge unul. Cu setarea de mai sus, un element care încă are data-animate este ignorat. Folosiți-o când un alt script de pe pagină citește deja data-animate sau când doriți ca marcajul să numească atributul după proiectul dvs.
În modul urmărire, Glaze observă atributul configurat, astfel încât schimbarea valorii lui data-move pe un element programează o reconstruire.
Sintaxă bazată pe clase
Preferați clasele în locul atributelor de date? Activați modul pentru clase:
glaze({
lib: { gsap: { core: gsap } },
className: "animate",
})
Acum puteți scrie animațiile ca clase:
<div class="animate-from:opacity-0|duration-1"></div>
Acest lucru funcționează bine dacă folosiți deja CSS utilitare mai întâi și doriți ca animațiile să aibă un aspect similar. Modul cu clase este util și când un sistem de șabloane vă permite să adăugați clase unui element, dar nu și atribute arbitrare.
Glaze citește fiecare clasă care începe cu prefixul urmat de o cratimă (animate- aici) și elimină acea parte. Clasele fără prefix rămân neschimbate, astfel încât clasele de animație pot sta alături de clasele de stilizare pe același element. Puteți împărți o animație în mai multe clase:
<div class="card animate-from:opacity-0 animate-from:y-24"></div>
Clasele responsive acceptă punctul de întrerupere fie după, fie înaintea prefixului. Ambele variante rulează numai când lg se potrivește cu punctul de întrerupere întrerupere:
<div class="animate-@lg:from:opacity-0"></div>
<div class="@lg:animate-from:opacity-0"></div>
Presetările funcționează la fel și în clase, de exemplu animate-preset-fadeIn.
Modul cu clase nu dezactivează atributul de date. Când un element le are pe ambele, Glaze le unește într-un singur șir: mai întâi valoarea atributului, apoi clasele prefixate, în ordinea în care apar în atributul class.
<div
class="animate-from:opacity-0 animate-@lg:from:y-50"
data-animate="from:duration-1"
></div>
Acest element se animează de la opacity: 0 timp de o secundă la orice dimensiune și, de asemenea, de la y: 50 când lg se potrivește. Deoarece șirurile sunt unite, se aplică aceeași regulă ca în cazul unui singur șir: când două părți setează aceeași proprietate, prevalează cea din urmă. Aici, valoarea clasei suprascrie valoarea atributului pentru x:
<div class="animate-to:x-100" data-animate="to:x-50|y-20"></div>
Elementul se animează către x: 100 și y: 20.
Cu watch activat în modul claselor, Glaze observă și modificările class. Adăugarea unei clase animate- unui element sau modificarea claselor unui element Glaze pe care deja îl citește sau îl animă programează o reconstrucție. Într-un element cu un selector relativ, modificările claselor descendenților săi au același efect, deoarece pot schimba elementele potrivite de selector. Modificările claselor altor elemente nu au acest efect, inclusiv cele ale strămoșilor elementelor animate, așa că activarea unei clase pentru modul întunecat pe <html> sau a unei clase de blocare a derulării pe <body> nu afectează animațiile în curs. Nici modificarea unei clase care face ca un element să corespundă pentru prima dată unui selector global nu este detectată; apelați refresh() după aceasta.
Limitarea căutării
Glaze caută în întregul document în mod implicit. Transmiteți element pentru a anima doar elementele din interiorul unui container:
glaze({
lib: { gsap: { core: gsap } },
element: document.querySelector("#app"),
})
element acceptă un Element sau un Document. Acesta limitează trei lucruri:
- Doar rădăcina și descendenții ei sunt parcurși pentru a găsi utilitare de animație. Elementele din alte părți ale paginii sunt ignorate, chiar dacă au
data-animate. - Modul de urmărire observă doar modificările din rădăcină.
destroy()curăță doar ceea ce a creat această instanță, astfel încât animațiile din alte părți ale paginii sunt păstrate.
Astfel, element este opțiunea potrivită pentru framework-urile de componente. Creați câte o instanță pentru fiecare componentă montată, folosind elementul rădăcină al componentei, și apelați destroy() la demontarea acesteia, după cum se arată în Actualizare și curățare. Atribuiți instanțelor separate rădăcini care nu se suprapun; un element din două rădăcini este animat de ambele instanțe.
Direcționarea către alte elemente
Opțiunile de mai sus stabilesc ce elemente citește Glaze. Un selector între paranteze drepte la începutul unui segment stabilește elementele cărora li se aplică animația. În lipsa acestuia, animația vizează elementul care conține utilitarele.
Selectori relativi
Un selector care începe cu & este rezolvat pornind de la elementul însuși, iar & reprezintă acel element. Selectorul este interogat cu querySelectorAll, deci poate găsi mai multe elemente:
<ul data-animate="[&>li]:from:opacity-0|y-20|stagger-0.1">
<li>One</li>
<li>Two</li>
<li>Three</li>
</ul>
[&>li] găsește elementele li directe. Valoarea stagger distanțează momentele lor de pornire cu 0.1 secunde. Folosiți această opțiune când un element trebuie să controleze animația unei liste, a unei grile sau a unui grup de elemente descendente, fără a adăuga un atribut fiecărui element.
Scrieți spațiile ca liniuțe de subliniere. [&_p] devine & p și găsește fiecare p din interiorul elementului, la orice nivel:
<article data-animate="[&_p]:from:opacity-0|stagger-0.2">
<p>First paragraph</p>
<div><p>Nested paragraph</p></div>
</article>
Fiecare liniuță de subliniere dintr-un selector este transformată într-un spațiu, așadar un nume de clasă care conține o liniuță de subliniere nu poate fi găsit în acest mod.
[&] singur se rezolvă la elementul însuși. Este folosit mai ales ca valoare, de exemplu scrollTrigger.trigger-[&] în ScrollTrigger și în valorile implicite ale cronologiei.
Selectori globali
Un selector fără & este transmis motorului de animație ca șir. GSAP și Motion îl rezolvă în întregul document, nu în raport cu elementul sau cu rădăcina element:
<h2 data-animate="[.badge]:from:opacity-0|scale-0.5|duration-0.3">Inbox</h2>
<span class="badge">3</span>
Acest lucru animează fiecare .badge de pe pagină, indiferent de poziția sa. În componente reutilizabile, preferați selectorii relativi, deoarece un selector global găsește și copiile componentei aflate în alte părți ale paginii.
Limite
Fiecare element are o singură țintă. Când mai multe segmente conțin un selector, ultimul se aplică tuturor stărilor elementului. Aici, atât from, cât și to se aplică elementului p, nu elementului h1:
<div data-animate="[&>h1]:from:opacity-0 [&>p]:to:x-20">
<h1>Title</h1>
<p>Text</p>
</div>
Pentru a anima două grupuri în mod diferit, aplicați utilitarele direct elementelor descendente sau grupați-le într-o cronologie.
Un selector se încheie la primul ], așadar selectorii care conțin paranteze drepte, cum sunt selectorii de atribute precum [&>[data-item]], nu sunt acceptați. Folosiți în schimb un selector de clasă sau de element.
Selectorii se combină cu punctele de întrerupere în ordinea descrisă în Sintaxă, de exemplu @lg:[&>div]:from:opacity-0.