Valijad
Vaikimisi otsib Glaze data-animate-atribuudiga elemente ja loob animatsiooni selle atribuudi väärtuse põhjal. Sellel lehel käsitletakse kolme valikut, mis muudavad seda, milliseid elemente Glaze loeb: dataAttribute, className ja element, ning nurksulgudes selektoreid, mis suunavad animatsiooni teistele elementidele. Stringis kasutatavaid utiliite kirjeldab jaotis Süntaks.
Kuidas elemente leitakse
Kui käivitatakse glaze(), ning iga refresh() või jälgimisrežiimi taasloomise ajal, läbitakse kõik juurelemendi sees olevad elemendid ja jäetakse alles need, millel on seadistatud atribuut või klassirežiimis seadistatud prefiksiga klass. Arvesse läheb ka juurelement ise, kui sellel on vastav väärtus. Elemente loetakse dokumendis esinemise järjekorras.
Sel viisil leitud element saab oma ajaskaala, välja arvatud juhul, kui see asub elemendi tl sees või viitab sellele väärtusega tl:<id>. Sel juhul lisatakse see element hoopis selle ajaskaalale. Rühmitamise kohta vt Ajaskaalad.
Kohandatud atribuut
Kasutage teist andmeatribuuti:
glaze({
lib: { gsap: { core: gsap } },
dataAttribute: "data-move",
})
Nüüd otsib Glaze atribuuti data-move, mitte atribuuti data-animate:
<div data-move="from:opacity-0"></div>
See valik asendab atribuudi, mitte ei lisa uut. Ülaltoodud seadistuse korral eiratakse elementi, millel on endiselt data-animate. Kasutage seda siis, kui mõni teine skript lehel loeb juba data-animate või kui soovite, et märgistus nimetaks atribuudi teie projekti järgi.
Režiimis jälgimine jälgib Glaze seadistatud atribuuti, nii et elemendi data-move väärtuse muutmine käivitab uue koostamise.
Klassipõhine süntaks
Eelistate andmeatribuutidele klasse? Lubage klassirežiim:
glaze({
lib: { gsap: { core: gsap } },
className: "animate",
})
Nüüd saate kirjutada animatsioone klassidena:
<div class="animate-from:opacity-0|duration-1"></div>
See sobib hästi, kui kasutate juba utility-first CSS-i ja soovite, et animatsioonid oleksid samas stiilis. Klassirežiim on kasulik ka siis, kui mallisüsteem lubab elemendile lisada klasse, kuid mitte suvalisi atribuute.
Glaze loeb kõik klassid, mis algavad prefiksile järgneva sidekriipsuga (siin animate-), ja eemaldab selle osa. Prefiksita klassid jäetakse alles, nii et animatsiooniklassid võivad samal elemendil paikneda kõrvuti stiiliklassidega. Animatsiooni saab jagada mitme klassi vahel:
<div class="card animate-from:opacity-0 animate-from:y-24"></div>
Reageerivad klassid võivad sisaldada murdepunkti kas enne või pärast prefiksit. Mõlemad variandid rakenduvad ainult siis, kui lg murdepunkt sobib:
<div class="animate-@lg:from:opacity-0"></div>
<div class="@lg:animate-from:opacity-0"></div>
Eelseadistused toimivad klassides samamoodi, näiteks animate-preset-fadeIn.
Klassirežiim ei lülita andmeatribuuti välja. Kui elemendil on mõlemad, ühendab Glaze need üheks stringiks: kõigepealt atribuudi väärtus, seejärel prefiksiga klassid nende järjekorras atribuudis class.
<div
class="animate-from:opacity-0 animate-@lg:from:y-50"
data-animate="from:duration-1"
></div>
See element animeerub igas suuruses opacity: 0-st ühe sekundi jooksul ning lisaks väärtusest y: 50, kui lg sobib. Kuna stringid ühendatakse, kehtib sama reegel mis ühe stringi sees: kui kaks osa määravad sama omaduse, jääb peale hilisem. Siin kirjutab klassi väärtus atribuudi väärtuse x puhul üle:
<div class="animate-to:x-100" data-animate="to:x-50|y-20"></div>
Element animeerub väärtustele x: 100 ja y: 20.
Kui watch on klassirežiimis sisse lülitatud, jälgib Glaze ka class muudatusi. animate- klassi lisamine elemendile või sellise elemendi klasside muutmine, mida Glaze juba loeb või animeerib, ajastab uuesti koostamise. Suhtelise valijaga elemendi sees põhjustavad seda ka selle järglaste klassimuudatused, sest need võivad muuta seda, millele valija vastab. Teiste elementide klassimuudatused seda ei põhjusta; see kehtib ka animeeritavate elementide eellaste kohta. Seega jätab tumeda režiimi klassi lülitamine elemendil <html> või kerimisluku klassi lülitamine elemendil <body> käimasolevad animatsioonid puutumata. Samuti ei märgata klassimuudatust, mille tõttu element hakkab vastama globaalsele valijale; kutsuge pärast seda refresh().
Otsingu piiramine
Glaze otsib vaikimisi kogu document-ist. Edastage element, et animeerida ainult konteineri sees olevaid elemente:
glaze({
lib: { gsap: { core: gsap } },
element: document.querySelector("#app"),
})
element aktsepteerib väärtust Element või Document. See piirab kolme asja:
- Animatsiooniutiliite otsitakse ainult juurelemendist ja selle järglastest. Mujal lehel olevad elemendid jäetakse tähelepanuta, isegi kui neil on
data-animate. - Jälgimisrežiim jälgib muudatusi ainult juurelemendi sees.
destroy()puhastab ainult selle eksemplari loodud sisu, nii et lehe muud osad säilitavad oma animatsioonid.
Seetõttu on element sobiv valik komponendiraamistikes. Looge iga ühendatud komponendi jaoks üks eksemplar, kasutades komponendi juurelementi, ja kutsuge lahtiühendamisel esile destroy(), nagu näidatud jaotises Värskendamine ja puhastamine. Andke eraldi eksemplaridele juurelemendid, mis ei kattu; kahes juurelemendis paiknevat elementi animeerivad mõlemad eksemplarid.
Teiste elementide sihtimine
Ülaltoodud suvandid määravad, milliseid elemente Glaze loeb. Segmendi alguses olev nurksulgudes selektor määrab, millistele elementidele animatsiooni rakendatakse. Kui selektorit pole, sihitakse animatsiooniutiliite kandvat elementi.
Suhtelised selektorid
&-ga algav selektor leitakse elemendi enda suhtes, kus & tähistab seda elementi. Seda otsitakse käsuga querySelectorAll, seega võib see sobida mitme elemendiga:
<ul data-animate="[&>li]:from:opacity-0|y-20|stagger-0.1">
<li>One</li>
<li>Two</li>
<li>Three</li>
</ul>
[&>li] sobib otseste li järglastega. Väärtus stagger paigutab nende algusajad 0.1 sekundi kaugusele. Kasutage seda, kui üks element peab juhtima loendi, ruudustiku või järglaste rühma animatsiooni, ilma et igale järglasele tuleks atribuut lisada.
Kirjutage tühikud alakriipsudena. [&_p] muutub kujule & p ja sobib elemendi sees igal sügavusel oleva p-ga:
<article data-animate="[&_p]:from:opacity-0|stagger-0.2">
<p>First paragraph</p>
<div><p>Nested paragraph</p></div>
</article>
Selektoris teisendatakse iga alakriips tühikuks, seega ei saa sel viisil leida klassinime, mis sisaldab alakriipsu.
[&] eraldi kasutatuna viitab elemendile endale. Seda kasutatakse peamiselt väärtusena, näiteks scrollTrigger.trigger-[&]-ga ScrollTrigger-s ja ajaskaala vaikeväärtustes.
Üldised selektorid
Ilma &-ta selektor edastatakse animatsioonimootorile stringina. GSAP ja Motion leiavad selle kogu dokumendist, mitte elemendi või element juurelemendi suhtes:
<h2 data-animate="[.badge]:from:opacity-0|scale-0.5|duration-0.3">Inbox</h2>
<span class="badge">3</span>
See animeerib lehel kõik .badge-id, olenemata nende asukohast. Korduvkasutatavates komponentides eelistage suhtelisi selektoreid, sest üldine selektor leiab ka komponendi koopiad mujal lehel.
Piirangud
Igal elemendil on üks sihtmärk. Kui mitu segmenti sisaldavad selektorit, rakendatakse viimast kõigile elemendi olekutele. Siin rakendatakse nii from kui ka to elemendile p, mitte elemendile h1:
<div data-animate="[&>h1]:from:opacity-0 [&>p]:to:x-20">
<h1>Title</h1>
<p>Text</p>
</div>
Kahe rühma erinevaks animeerimiseks lisage utiliidid otse järglastele või rühmitage need ajajoone abil.
Selektor lõpeb esimese ] juures, seega ei toetata nurksulge sisaldavaid selektoreid, näiteks atribuudi selektoreid nagu [&>[data-item]]. Kasutage selle asemel klassi- või elemendiselektorit.
Selektorid kombineeritakse murdepunktidega jaotises Süntaks kirjeldatud järjekorras, näiteks @lg:[&>div]:from:opacity-0.