Atlasītāji
Pēc noklusējuma Glaze meklē elementus ar atribūtu data-animate un izveido animāciju, pamatojoties uz šī atribūta vērtību. Šajā lapā aplūkotas trīs opcijas, kas maina, kurus elementus nolasa Glaze: dataAttribute, className un element, kā arī iekavu selektori, kas animāciju piesaista citiem elementiem. Virknes utilītas aprakstītas sadaļā Sintakse.
Kā tiek atrasti elementi
Kad darbojas glaze() un pēc tam katrā refresh() vai novērošanas režīma pārbūvē, tas pārstaigā visus elementus saknes elementā un patur tos, kuriem ir konfigurētais atribūts vai, klašu režīmā, klase ar konfigurēto prefiksu. Arī pats saknes elements tiek ņemts vērā, ja tam ir šāds atribūts vai klase. Elementi tiek nolasīti dokumenta secībā.
Katram šādi atrastajam elementam tiek izveidota sava laika skala, ja vien tas neatrodas elementā tl vai nav ar to sasaistīts, izmantojot tl:<id>. Šādā gadījumā tas tiek pievienots šai laika skalai. Skatiet sadaļu Laika skalas, lai uzzinātu, kā darbojas grupēšana.
Pielāgots atribūts
Izmantojiet citu datu atribūtu:
glaze({
lib: { gsap: { core: gsap } },
dataAttribute: "data-move",
})
Tagad Glaze meklēs data-move, nevis data-animate:
<div data-move="from:opacity-0"></div>
Opcija aizstāj atribūtu, nevis pievieno tam vēl vienu. Izmantojot iepriekš minēto iestatījumu, elements, kuram joprojām ir data-animate, tiek ignorēts. Izmantojiet šo opciju, ja cits lapas skripts jau nolasa data-animate vai ja vēlaties, lai marķējumā atribūtam būtu jūsu projekta nosaukums.
Režīmā novērošana Glaze novēro konfigurēto atribūtu, tāpēc, mainot elementa data-move vērtību, tiek ieplānota atkārtota izveide.
Klašu sintakse
Vai dodat priekšroku klasēm, nevis datu atribūtiem? Ieslēdziet klašu režīmu:
glaze({
lib: { gsap: { core: gsap } },
className: "animate",
})
Tagad animācijas var rakstīt kā klases:
<div class="animate-from:opacity-0|duration-1"></div>
Tas labi darbojas, ja jau izmantojat utilītās balstītu pieeju CSS un vēlaties, lai animācijas būtu līdzīgas. Klašu režīms noder arī tad, ja veidņu sistēma ļauj elementam pievienot klases, bet ne patvaļīgus atribūtus.
Glaze nolasa visas klases, kas sākas ar prefiksu, kam seko defise (šeit animate-), un noņem šo daļu. Klases bez prefiksa paliek nemainītas, tāpēc animācijas klases var atrasties līdzās stila klasēm vienā elementā. Animāciju var sadalīt vairākās klasēs:
<div class="card animate-from:opacity-0 animate-from:y-24"></div>
Adaptīvām klasēm pārtraukuma punktu var norādīt gan aiz prefiksa, gan pirms tā. Abas šīs klases darbojas tikai tad, ja atbilst lg pārtraukuma punkts:
<div class="animate-@lg:from:opacity-0"></div>
<div class="@lg:animate-from:opacity-0"></div>
Sākotnējie iestatījumi klasēs darbojas tāpat, piemēram, animate-preset-fadeIn.
Klašu režīms neizslēdz datu atribūtu. Ja elementam ir abi, Glaze apvieno tos vienā virknē: vispirms atribūta vērtība, pēc tam prefiksētās klases tādā secībā, kādā tās norādītas atribūtā class.
<div
class="animate-from:opacity-0 animate-@lg:from:y-50"
data-animate="from:duration-1"
></div>
Šis elements animējas no opacity: 0 vienas sekundes laikā jebkurā ekrāna izmērā, kā arī no y: 50, ja atbilst lg. Tā kā virknes tiek apvienotas, ir spēkā tas pats noteikums, kas vienā virknē: ja divas daļas iestata vienu un to pašu rekvizītu, uzvar vēlākā. Šeit klases vērtība aizstāj atribūta vērtību rekvizītam x:
<div class="animate-to:x-100" data-animate="to:x-50|y-20"></div>
Elements animējas uz x: 100 un y: 20.
Kad watch ir iespējots klašu režīmā, Glaze novēro arī class izmaiņas. Pievienojot elementam animate- klasi vai mainot tā elementa klases, ko Glaze jau nolasa vai animē, tiek ieplānota atkārtota izveide. Elementā ar relatīvo selektoru atkārtota izveide tiek ieplānota arī tad, ja mainās tā pēcteču klases, jo tas var mainīt selektora atbilstību. Citu elementu klašu izmaiņas to neizraisa, un tas attiecas arī uz animēto elementu senčiem. Tāpēc tumšā režīma klases pārslēgšana elementam <html> vai ritināšanas bloķēšanas klases pārslēgšana elementam <body> netraucē jau notiekošās animācijas. Arī klašu izmaiņas, kuru dēļ elements sāk atbilst globālam selektoram, netiek pamanītas; pēc tam izsauciet refresh().
Meklēšanas ierobežošana
Glaze pēc noklusējuma meklē visā document. Norādiet element, lai animētu tikai elementus konteinerā:
glaze({
lib: { gsap: { core: gsap } },
element: document.querySelector("#app"),
})
element pieņem Element vai Document. Tas ierobežo trīs lietas:
- Animācijas utilītas tiek meklētas tikai saknes elementā un tā pēctečos. Pārējie lapas elementi tiek ignorēti, pat ja tiem ir
data-animate. - Novērošanas režīms uzrauga tikai izmaiņas saknes elementa iekšienē.
destroy()notīra tikai to, ko izveidojis šis instances eksemplārs, tāpēc citur lapā animācijas paliek.
Tāpēc element ir piemērotākā izvēle komponentu ietvariem. Izveidojiet atsevišķu instances eksemplāru katram uzstādītajam komponentam, norādot komponenta saknes elementu, un, komponentu noņemot, izsauciet destroy(), kā parādīts sadaļā Atsvaidzināšana un tīrīšana. Atsevišķiem instances eksemplāriem norādiet saknes elementus, kas nepārklājas; elementu saknes elementu pārklāšanās zonā animē abi instances eksemplāri.
Citu elementu atlasīšana
Iepriekš minētās opcijas nosaka, kurus elementus nolasa Glaze. Segmenta sākumā norādīts selektors kvadrātiekavās nosaka, kuriem elementiem piemēro animāciju. Ja selektors nav norādīts, animācija tiek piemērota elementam, kurā atrodas utilītas.
Relatīvie selektori
Selektors, kas sākas ar &, tiek atrisināts attiecībā pret pašu elementu, un & apzīmē šo elementu. Tas tiek vaicāts ar querySelectorAll, tāpēc var atlasīt vairākus elementus:
<ul data-animate="[&>li]:from:opacity-0|y-20|stagger-0.1">
<li>One</li>
<li>Two</li>
<li>Three</li>
</ul>
[&>li] atlasa tiešos li bērnelementus. Vērtība stagger izvieto to sākuma laikus ar 0.1 sekundes atstarpi. Izmantojiet šo iespēju, ja vienam elementam jāvada saraksta, režģa vai bērnelementu grupas animācija, nepievienojot atribūtu katram bērnelementam.
Atstarpju vietā rakstiet pasvītrojumus. [&_p] kļūst par & p un atlasa ikvienu p elementa iekšienē jebkurā dziļumā:
<article data-animate="[&_p]:from:opacity-0|stagger-0.2">
<p>First paragraph</p>
<div><p>Nested paragraph</p></div>
</article>
Katrs selektorā esošais pasvītrojums tiek pārvērsts par atstarpi, tāpēc šādi nevar atlasīt klases nosaukumu, kurā ir pasvītrojums.
[&] pats par sevi tiek atrisināts kā pats elements. To galvenokārt izmanto kā vērtību, piemēram, scrollTrigger.trigger-[&] sadaļā ScrollTrigger un laika līnijas noklusējuma vērtībās.
Globālie selektori
Selektors bez & tiek nodots animāciju programmai kā virkne. Gan GSAP, gan Motion to atrisina visā dokumentā, nevis attiecībā pret elementu vai saknes elementu element:
<h2 data-animate="[.badge]:from:opacity-0|scale-0.5|duration-0.3">Inbox</h2>
<span class="badge">3</span>
Tas animē katru .badge lapā neatkarīgi no tā atrašanās vietas. Atkārtoti izmantojamos komponentos dodiet priekšroku relatīvajiem selektoriem, jo globāls selektors atlasa arī citas šī komponenta kopijas lapā.
Ierobežojumi
Katram elementam ir viens mērķis. Ja vairākos segmentos ir selektors, pēdējais attiecas uz visiem elementa stāvokļiem. Šeit gan from, gan to tiek piemērots elementam p, nevis h1:
<div data-animate="[&>h1]:from:opacity-0 [&>p]:to:x-20">
<h1>Title</h1>
<p>Text</p>
</div>
Lai animētu divas grupas atšķirīgi, norādiet utilītas pašos bērnelementos vai grupējiet tos laika līnijā.
Selektors beidzas pie pirmās ], tāpēc selektori, kuros ir kvadrātiekavas, piemēram, atribūtu selektori [&>[data-item]], netiek atbalstīti. Tā vietā izmantojiet klases vai elementa selektoru.
Selektori tiek kombinēti ar pārtraukuma punktiem secībā, kas aprakstīta sadaļā Sintakse, piemēram, @lg:[&>div]:from:opacity-0.