Siirry sisältöön

Valitsimet

Oletusarvoisesti Glaze etsii elementtejä, joilla on attribuutti data-animate, ja muodostaa animaation kyseisen attribuutin arvon perusteella. Tällä sivulla käsitellään kolmea asetusta, jotka muuttavat sitä, mitkä elementit Glaze lukee: dataAttribute, className ja element, sekä hakasuljevalitsimia, joilla animaatio kohdistetaan muihin elementteihin. Merkkijonon sisältämät apufunktiot kuvataan kohdassa Syntaksi.

Elementtien löytäminen

Kun glaze() suoritetaan ja uudelleen jokaisen refresh()-kerran tai tarkkailutilan uudelleenrakennuksen yhteydessä, se käy läpi kaikki juuren sisällä olevat elementit ja säilyttää ne, joilla on määritetty attribuutti tai luokkatilassa luokka, jonka etuliite on määritetty. Myös juurielementti lasketaan mukaan, jos sillä on tällainen attribuutti tai luokka. Elementit luetaan dokumentin järjestyksessä.

Kukin tällä tavalla löydetty elementti saa oman aikajanansa, ellei se sijaitse tl-elementin sisällä tai viittaa sellaiseen komennolla tl:<id>. Tällöin se lisätään kyseiseen aikajanaan. Katso kohdasta Aikajanat, miten ryhmittely toimii.

Mukautettu attribuutti

Käytä toista data-attribuuttia:

JavaScript
glaze({
  lib: { gsap: { core: gsap } },
  dataAttribute: "data-move",
})

Nyt Glaze etsii data-move-attribuuttia data-animate-attribuutin sijaan:

HTML
<div data-move="from:opacity-0"></div>

Asetus korvaa määritteen sen sijaan, että lisäisi uuden. Yllä olevalla asetuksella elementti, jossa on edelleen data-animate, ohitetaan. Käytä tätä, kun sivun toinen skripti lukee jo data-animate tai kun haluat merkinnän määritteen nimen vastaavan projektiasi.

Katselutilassa Glaze tarkkailee määritettyä määritettä, joten arvon data-move muuttaminen elementissä ajoittaa uudelleenrakennuksen.

Luokkapohjainen syntaksi

Suositko luokkia data-attribuuttien sijaan? Ota luokkatila käyttöön:

JavaScript
glaze({
  lib: { gsap: { core: gsap } },
  className: "animate",
})

Nyt voit kirjoittaa animaatioita luokkina:

HTML
<div class="animate-from:opacity-0|duration-1"></div>

Tämä toimii hyvin, jos käytät jo utility-first CSS-lähestymistapaa ja haluat animaatioidesi tuntuvan samankaltaisilta. Luokkatila on hyödyllinen myös silloin, kun mallipohjajärjestelmä sallii luokkien lisäämisen elementtiin mutta ei mielivaltaisia määritteitä.

Glaze lukee kaikki luokat, jotka alkavat etuliitteellä ja sitä seuraavalla yhdysmerkillä (tässä animate-), ja poistaa tämän osan. Luokat, joissa etuliitettä ei ole, jätetään ennalleen, joten animaatioluokat voivat olla samassa elementissä tyyliluokkien rinnalla. Voit jakaa animaation useaan luokkaan:

HTML
<div class="card animate-from:opacity-0 animate-from:y-24"></div>

Responsiivisissa luokissa keskeytyspisteen voi kirjoittaa joko etuliitteen jälkeen tai ennen sitä. Molemmat suoritetaan vain, kun lg keskeytyspiste täsmää:

HTML
<div class="animate-@lg:from:opacity-0"></div>
<div class="@lg:animate-from:opacity-0"></div>

Esiasetukset toimivat luokissa samalla tavalla, esimerkiksi animate-preset-fadeIn.

Luokkatila ei poista data-attribuuttia käytöstä. Kun elementillä on molemmat, Glaze yhdistää ne yhdeksi merkkijonoksi: ensin attribuutin arvo, sitten etuliitteelliset luokat siinä järjestyksessä kuin ne esiintyvät class-attribuutissa.

HTML
<div
  class="animate-from:opacity-0 animate-@lg:from:y-50"
  data-animate="from:duration-1"
></div>

Tämä elementti animoi arvosta opacity: 0 yhden sekunnin ajan kaikissa kokoluokissa ja lisäksi arvosta y: 50, kun lg täsmää. Koska merkkijonot yhdistetään, sama sääntö pätee kuin yhdessä merkkijonossa: kun kaksi osaa asettaa saman ominaisuuden, myöhempi voittaa. Tässä luokan arvo ohittaa määritteen arvon ominaisuudelle x:

HTML
<div class="animate-to:x-100" data-animate="to:x-50|y-20"></div>

Elementti animoi arvoihin x: 100 ja y: 20.

Kun watch on käytössä luokkatilassa, Glaze seuraa myös class-muutoksia. animate--luokan lisääminen elementtiin tai sellaisen elementin luokkien muuttaminen, jota Glaze jo lukee tai animoi, ajoittaa uudelleenrakennuksen. Suhteellista valitsinta sisältävän elementin jälkeläisten luokkien muutokset tekevät samoin, koska ne voivat muuttaa sitä, mitä valitsin vastaa. Muiden elementtien luokkamuutokset eivät käynnistä uudelleenrakennusta, eivätkä myöskään animoitujen elementtien esi-isien muutokset. Siksi pimeän tilan luokan vaihtaminen elementissä <html> tai vierityslukon luokan vaihtaminen elementissä <body> ei vaikuta käynnissä oleviin animaatioihin. Myöskään luokkamuutosta, jonka seurauksena elementti alkaa vastata globaalia valitsinta, ei huomata; kutsu sen jälkeen refresh().

Glaze etsii oletuksena koko document-alueelta. Välitä element, jos haluat animoida vain säilön sisällä olevia elementtejä:

JavaScript
glaze({
  lib: { gsap: { core: gsap } },
  element: document.querySelector("#app"),
})

element hyväksyy arvoksi joko Element tai Document. Se rajaa kolmea asiaa:

  • Vain juuri ja sen jälkeläiset käydään läpi animaatiotyökalujen varalta. Muualla sivulla olevat elementit ohitetaan, vaikka niissä olisi data-animate.
  • Katselutila tarkkailee muutoksia vain juuren sisällä.
  • destroy() siivoaa vain tämän esiintymän luomat asiat, joten sivun muiden osien animaatiot säilyvät.

Tämän vuoksi element sopii komponenttikehyksiin. Luo jokaista liitettyä komponenttia varten yksi esiintymä käyttämällä komponentin juurielementtiä ja kutsu destroy()-toimintoa komponentin poistuessa, kuten kohdassa Päivittäminen ja siivous näytetään. Anna erillisille esiintymille juuret, jotka eivät mene päällekkäin; kahden juuren sisällä oleva elementti animoidaan kummallakin esiintymällä.

Muiden elementtien kohdistaminen

Yllä olevat asetukset määrittävät, mitkä elementit Glaze lukee. Segmentin alussa oleva hakasulkeisiin merkitty valitsin määrittää, mihin elementteihin animaatio kohdistetaan. Ilman valitsinta animaatio kohdistuu elementtiin, jossa työkaluluokat ovat.

Suhteelliset valitsimet

Elementistä itsestään käsin ratkaistaan valitsin, joka alkaa merkillä &; & tarkoittaa kyseistä elementtiä. Valitsinta haetaan querySelectorAll-toiminnolla, joten se voi osua useaan elementtiin:

HTML
<ul data-animate="[&>li]:from:opacity-0|y-20|stagger-0.1">
  <li>One</li>
  <li>Two</li>
  <li>Three</li>
</ul>

[&>li] osuu suoriin li-lapsiin. Arvo stagger sijoittaa niiden aloitusajat 0.1 sekunnin välein. Käytä tätä, kun yhden elementin pitäisi ohjata luettelon, ruudukon tai lapsiryhmän animaatiota lisäämättä määritettä jokaiseen lapseen.

Kirjoita välilyönnit alaviivoina. [&_p] muuttuu muotoon & p ja osuu kaikkiin elementin sisällä oleviin p-elementteihin syvyydestä riippumatta:

HTML
<article data-animate="[&_p]:from:opacity-0|stagger-0.2">
  <p>First paragraph</p>
  <div><p>Nested paragraph</p></div>
</article>

Valitsimen jokainen alaviiva muutetaan välilyönniksi, joten alaviivan sisältävää luokan nimeä ei voi kohdistaa tällä tavalla.

[&] yksinään palauttaa elementin itsensä. Sitä käytetään enimmäkseen arvona, esimerkiksi scrollTrigger.trigger-[&] kohdassa ScrollTrigger ja aikajanalla oletusarvot.

Yleiset valitsimet

Valitsin, joka ei sisällä merkkiä &, välitetään animaatiomoottorille merkkijonona. GSAP ja Motion ratkaisevat sen koko dokumentista, eivät elementistä tai element-juuresta:

HTML
<h2 data-animate="[.badge]:from:opacity-0|scale-0.5|duration-0.3">Inbox</h2>
<span class="badge">3</span>

Tämä animoi jokaisen sivulla olevan .badge-elementin sen sijainnista riippumatta. Suosi suhteellisia valitsimia uudelleenkäytettävissä komponenteissa, koska yleinen valitsin osuu myös sivun muualla oleviin komponentin kopioihin.

Rajoitukset

Jokaisella elementillä on yksi kohde. Kun useassa segmentissä on valitsin, viimeistä käytetään elementin kaikissa tiloissa. Tässä sekä from että to kohdistuvat p-elementtiin, eivät h1-elementtiin:

HTML
<div data-animate="[&>h1]:from:opacity-0 [&>p]:to:x-20">
  <h1>Title</h1>
  <p>Text</p>
</div>

Jos haluat animoida kahta ryhmää eri tavoin, lisää työkaluluokat suoraan lapsiin tai ryhmittele ne aikajanalle.

Valitsin päättyy ensimmäiseen merkkiin ], joten hakasulkeita sisältäviä valitsimia, kuten attribuuttivalitsinta [&>[data-item]], ei tueta. Käytä sen sijaan luokka- tai elementtivalitsinta.

Valitsimet yhdistyvät keskeytyspisteisiin kohdassa Syntaksi kuvatulla tavalla, esimerkiksi @lg:[&>div]:from:opacity-0.