Izbirniki
Privzeto Glaze poišče elemente z atributom data-animate in zgradi animacijo na podlagi vrednosti tega atributa. Ta stran obravnava tri možnosti, ki določajo, katere elemente bere Glaze: dataAttribute, className in element, ter izbirnike v oglatih oklepajih, ki animacijo usmerijo na druge elemente. Funkcije znotraj niza so opisane v razdelku Sintaksa.
Kako najde elemente
Ko se zažene glaze(), pa tudi ob vsaki ponovni gradnji refresh() ali v načinu spremljanja, pregleda vse elemente znotraj korena in izbere tiste, ki imajo konfigurirani atribut ali pa v načinu razredov razred s konfigurirano predpono. Mednje spada tudi korenski element, če ima ustrezen atribut ali razred. Elementi se berejo v vrstnem redu dokumenta.
Vsak tako najden element dobi svojo časovnico, razen če je znotraj elementa tl ali je prek tl:<id> povezan z njim. V tem primeru se namesto tega doda na njegovo časovnico. Za način združevanja glejte Časovnice.
Atribut po meri
Uporabite drug atribut podatkov:
glaze({
lib: { gsap: { core: gsap } },
dataAttribute: "data-move",
})
Zdaj bo Glaze iskal data-move namesto data-animate:
<div data-move="from:opacity-0"></div>
Možnost zamenja atribut, namesto da bi dodala novega. Z zgornjo nastavitvijo je element, ki še vedno vsebuje data-animate, prezrt. Uporabite jo, če druga skripta na strani že bere data-animate ali če želite, da oznaka v označevalni kodi poimenuje atribut po vašem projektu.
V načinu opazovanja Glaze spremlja konfigurirani atribut, zato sprememba vrednosti data-move na elementu sproži ponovno gradnjo.
Sintaksa z razredi
Imate raje razrede kot atribute podatkov? Omogočite način razredov:
glaze({
lib: { gsap: { core: gsap } },
className: "animate",
})
Zdaj lahko animacije zapišete kot razrede:
<div class="animate-from:opacity-0|duration-1"></div>
To se dobro obnese, če že uporabljate pristop CSS, ki temelji na pripomočkih, in želite, da so vaše animacije videti podobno. Način z razredi je uporaben tudi, kadar vam sistem predlog omogoča dodajanje razredov elementu, ne pa poljubnih atributov.
Glaze prebere vsak razred, ki se začne s predpono, ki ji sledi vezaj (tukaj animate-), in odstrani ta del. Razredi brez predpone ostanejo nespremenjeni, zato so lahko animacijski razredi ob slogovnih razredih na istem elementu. Animacijo lahko razdelite med več razredov:
<div class="card animate-from:opacity-0 animate-from:y-24"></div>
Odzivni razredi sprejemajo prelomno točko za predpono ali pred njo. Oboje deluje samo, ko se ujema prelomna točka lg prelomne točke:
<div class="animate-@lg:from:opacity-0"></div>
<div class="@lg:animate-from:opacity-0"></div>
Prednastavitve delujejo enako tudi v razredih, na primer animate-preset-fadeIn.
Način z razredi ne izklopi podatkovnega atributa. Če ima element oboje, Glaze združi vrednosti v en niz: najprej vrednost atributa, nato pa razrede s predpono v vrstnem redu, v katerem so navedeni v atributu class.
<div
class="animate-from:opacity-0 animate-@lg:from:y-50"
data-animate="from:duration-1"
></div>
Ta element se animira iz opacity: 0 v eni sekundi pri vseh velikostih, pa tudi iz y: 50, ko se ujema lg. Ker sta niza združena, velja isto pravilo kot znotraj enega niza: ko dva dela določata isto lastnost, zmaga poznejši. Tukaj vrednost razreda preglasi vrednost atributa za x:
<div class="animate-to:x-100" data-animate="to:x-50|y-20"></div>
Element se animira v x: 100 in y: 20.
Ko je v načinu razredov omogočen watch, Glaze spremlja tudi spremembe class. Če elementu dodate razred animate- ali spremenite razrede elementa, ki ga Glaze že bere ali animira, se načrtuje ponovna izgradnja. Znotraj elementa z relativnim izbirnikom se enako zgodi tudi ob spremembi razredov njegovih potomcev, saj lahko to spremeni, katere elemente izbirnik zadene. Spremembe razredov drugih elementov ne sprožijo ponovne izgradnje; to velja tudi za prednike animiranih elementov, zato preklop razreda za temni način na <html> ali razreda za zaklepanje drsenja na <body> ne vpliva na animacije, ki se že izvajajo. Zaznana ni niti sprememba razreda, zaradi katere se element na novo ujema z globalnim izbirnikom; po njej pokličite refresh().
Omejitev iskanja
Glaze privzeto preišče celoten document. Podajte element, če želite animirati samo elemente znotraj vsebnika:
glaze({
lib: { gsap: { core: gsap } },
element: document.querySelector("#app"),
})
element sprejema Element ali Document. Omeji tri stvari:
- Za animacijske pripomočke se pregledata samo korenski element in njegovi potomci. Elementi drugje na strani so prezrti, tudi če vsebujejo
data-animate. - Način opazovanja spremlja samo spremembe znotraj korenskega elementa.
destroy()počisti samo tisto, kar je ustvaril ta primerek, zato animacije v drugih delih strani ostanejo.
Zato je element primerna možnost za ogrodja komponent. Za vsako nameščeno komponento ustvarite en primerek s korenskim elementom komponente in ob njeni odstranitvi pokličite destroy(), kot je prikazano v razdelku Osveževanje in čiščenje. Ločenim primerkom določite korenske elemente, ki se ne prekrivajo; element znotraj dveh korenskih elementov animirata oba primerka.
Izbiranje drugih elementov
Zgornje možnosti določajo, katere elemente bere Glaze. Izbirnik v oglatih oklepajih na začetku segmenta določa, za katere elemente se uporabi animacija. Če ga ni, je cilj animacije element, ki vsebuje pripomočke.
Relativni izbirniki
Izbirnik, ki se začne z &, se razreši glede na sam element, pri čemer & predstavlja ta element. Izvede se poizvedba z querySelectorAll, zato se lahko ujema z več elementi:
<ul data-animate="[&>li]:from:opacity-0|y-20|stagger-0.1">
<li>One</li>
<li>Two</li>
<li>Three</li>
</ul>
[&>li] se ujema z neposrednimi podrejenimi elementi li. Vrednost stagger razmakne njihove začetne čase za 0.1 sekunde. Uporabite to, kadar naj en element upravlja animacijo seznama, mreže ali skupine podrejenih elementov, ne da bi vsakemu podrejenemu elementu dodali atribut.
Presledke zapišite kot podčrtaje. [&_p] postane & p in se ujema z vsakim p znotraj elementa na poljubni globini:
<article data-animate="[&_p]:from:opacity-0|stagger-0.2">
<p>First paragraph</p>
<div><p>Nested paragraph</p></div>
</article>
Vsak podčrtaj v izbirniku se pretvori v presledek, zato imena razreda, ki vsebuje podčrtaj, na ta način ni mogoče najti.
Samostojni [&] se razreši v sam element. Uporablja se predvsem kot vrednost, na primer scrollTrigger.trigger-[&] v ScrollTrigger in privzete nastavitve časovnice privzetih nastavitev.
Globalni izbirniki
Izbirnik brez & se mehanizmu animacij posreduje kot niz. GSAP in Motion ga razrešita glede na celoten dokument, ne glede na element ali korenski element element:
<h2 data-animate="[.badge]:from:opacity-0|scale-0.5|duration-0.3">Inbox</h2>
<span class="badge">3</span>
To animira vsak .badge na strani, ne glede na njegovo mesto. Znotraj ponovno uporabljivih komponent raje uporabite relativne izbirnike, saj se globalni izbirnik ujema tudi s kopijami komponente drugje na strani.
Omejitve
Vsak element ima en cilj. Če več segmentov vsebuje izbirnik, se zadnji uporabi za vsa stanja elementa. Tukaj se tako from kot to uporabita za p, ne pa za h1:
<div data-animate="[&>h1]:from:opacity-0 [&>p]:to:x-20">
<h1>Title</h1>
<p>Text</p>
</div>
Če želite dve skupini animirati različno, pripomočke postavite neposredno na podrejene elemente ali jih združite v časovnico.
Izbirnik se konča pri prvem ], zato izbirniki z oglatimi oklepaji, kot so atributni izbirniki [&>[data-item]], niso podprti. Namesto njih uporabite izbirnik razreda ali elementa.
Izbirniki se združujejo s prelomnimi točkami v vrstnem redu, opisanem v razdelku Sintaksa, na primer @lg:[&>div]:from:opacity-0.