Pereiti prie turinio

Parinkikliai

Pagal numatymą Glaze ieško elementų su atributu data-animate ir kuria animaciją pagal to atributo reikšmę. Šiame puslapyje aptariamos trys parinktys, keičiančios, kuriuos elementus nuskaito Glaze: dataAttribute, className ir element, taip pat laužtinių skliaustų parinkikliai, nukreipiantys animaciją į kitus elementus. Eilutėje naudojamos priemonės aprašytos puslapyje Sintaksė.

Kaip randami elementai

Vykdant glaze(), taip pat po kiekvieno refresh() arba stebėjimo režimo atkūrimo iš naujo, pereinama per kiekvieną šakninio elemento viduje esantį elementą ir paliekami tie, kurie turi sukonfigūruotą atributą arba, naudojant klasių režimą, klasę su sukonfigūruotu prefiksu. Jei šakninio elemento atributas atitinka, įtraukiamas ir jis pats. Elementai nuskaitomi dokumento tvarka.

Kiekvienas taip rastas elementas gauna savo laiko juostą, nebent jis yra elemento tl viduje arba susietas su juo naudojant tl:<id>. Tokiu atveju jis pridedamas prie tos laiko juostos. Kaip veikia grupavimas, žr. Laiko juostos.

Pasirinktinis atributas

Naudokite kitą duomenų atributą:

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

Dabar Glaze ieškos data-move, o ne data-animate:

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

Parinktis pakeičia atributą, o ne prideda kitą. Nustačius, kaip nurodyta aukščiau, ignoruojamas elementas, turintis data-animate. Naudokite šią parinktį, kai kitas puslapio scenarijus jau skaito data-animate arba kai norite, kad žymėjime atributo pavadinimas atitiktų jūsų projektą.

Stebėjimo režimu Glaze stebi sukonfigūruotą atributą, todėl pakeitus elemento data-move reikšmę suplanuojamas perrinkimas.

Klasių sintaksė

Teikiate pirmenybę klasėms, o ne duomenų atributams? Įjunkite klasių režimą:

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

Dabar animacijas galite nurodyti kaip klases:

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

Tai puikiai tinka, jei jau naudojate utility-first CSS ir norite, kad animacijos atrodytų panašiai. Klasių režimas taip pat naudingas, kai šablonų sistema leidžia elementui pridėti klases, bet ne savavališkus atributus.

Glaze nuskaito visas klases, prasidedančias prefiksu, po kurio eina brūkšnelis (čia animate-), ir pašalina šią dalį. Klasės be prefikso paliekamos nepakeistos, todėl animacijos klasės gali būti greta stiliaus klasių tame pačiame elemente. Animaciją galite padalyti į kelias klases:

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

Reaguojančiose klasėse lūžio tašką galima nurodyti prieš prefiksą arba po jo. Abu šie variantai veikia tik tada, kai sutampa lg lūžio taškas:

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

Išankstinės nuostatos klasėse veikia taip pat, pavyzdžiui, animate-preset-fadeIn.

Klasių režimas neišjungia duomenų atributo. Kai elementas turi abu, Glaze sujungia juos į vieną eilutę: pirmiausia atributo reikšmę, tada prefiksuotas klases tokia tvarka, kokia jos pateiktos atribute class.

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

Šis elementas animuojamas iš opacity: 0 per vieną sekundę bet kokio dydžio ekrane, taip pat iš y: 50, kai sutampa lg. Kadangi eilutės sujungiamos, galioja ta pati taisyklė kaip ir vienoje eilutėje: kai dvi dalys nustato tą pačią ypatybę, laimi vėlesnė. Čia klasės reikšmė pakeičia atributo reikšmę, skirtą x:

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

Elementas animuojamas į x: 100 ir y: 20.

Kai watch įjungtas klasės režimas, Glaze taip pat stebi class pakeitimus. Pridėjus elementui animate- klasę arba pakeitus elemento, kurį Glaze jau nuskaito ar animuoja, klases, suplanuojamas pakartotinis kūrimas. Elemento, kuriame yra santykinis selektorius, palikuonių klasių pakeitimai taip pat suplanuoja pakartotinį kūrimą, nes dėl jų gali pasikeisti, ką atitinka selektorius. Kitų elementų klasių pakeitimai to nedaro, įskaitant animuojamų elementų protėvius, todėl perjungus tamsiojo režimo klasę elementui <html> arba slinkimo užrakto klasę elementui <body>, vykdomos animacijos nenutrūksta. Taip pat nepastebima, kai dėl klasės pakeitimo elementas naujai atitinka visuotinį selektorių; po to iškvieskite refresh().

Glaze pagal numatytuosius nustatymus ieško visame document. Perduokite element, kad būtų animuojami tik konteineryje esantys elementai:

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

element priima Element arba Document. Jis apriboja tris dalykus:

  • Animacijos utilitų ieškoma tik šakniniame elemente ir jo palikuoniuose. Kiti puslapio elementai ignoruojami, net jei jie turi data-animate.
  • Stebėjimo režimu stebimi tik šakniniame elemente atliekami pakeitimai.
  • destroy() išvalo tik tai, ką sukūrė šis egzempliorius, todėl kitose puslapio vietose animacijos išlieka.

Todėl element ypač tinka komponentų karkasams. Kiekvienam prijungtam komponentui sukurkite po egzempliorių, nurodydami komponento šakninį elementą, o jį atjungdami iškvieskite destroy(), kaip parodyta skiltyje Atnaujinimas ir išvalymas. Atskirų egzempliorių šakniniai elementai neturi persidengti; elementą dviejų šakninių elementų viduje animuos abu egzemplioriai.

Kitų elementų pasirinkimas

Pirmiau aprašytos parinktys nustato, kuriuos elementus nuskaito Glaze. Segmento pradžioje esantis laužtinių skliaustų selektorius nustato, kuriems elementams taikoma animacija. Jei jo nėra, animacija taikoma elementui, kuriame yra utilitos.

Santykiniai selektoriai

Selektorius, prasidedantis &, nustatomas pagal patį elementą, o & kodas nurodo tą elementą. Paieška atliekama naudojant querySelectorAll, todėl selektorius gali atitikti kelis elementus:

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

[&>li] atitinka tiesioginius li vaikus. Reikšmė stagger nustato 0,1 sekundės intervalą tarp jų animacijos pradžios laikų. Naudokite tai, kai vienas elementas turi valdyti sąrašo, tinklelio ar vaikinių elementų grupės animaciją, nepridedant atributo prie kiekvieno vaiko.

Tarpus rašykite kaip pabraukimo brūkšnius. [&_p] tampa & p ir atitinka visus p elemento viduje bet kokiame gylyje:

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

Kiekvienas pabraukimo brūkšnys selektoriuje paverčiamas tarpu, todėl taip nepavyks pasirinkti klasės pavadinimo, kuriame yra pabraukimo brūkšnys.

[&] be papildomų dalių nurodo patį elementą. Dažniausiai jis naudojamas kaip reikšmė, pavyzdžiui, scrollTrigger.trigger-[&] skiltyje ScrollTrigger ir laiko juostos numatytosiose nuostatose.

Globalūs selektoriai

Selektorius be & animacijos varikliui perduodamas kaip eilutė. GSAP ir Motion jį nustato visame dokumente, o ne pagal elementą ar element šakninį elementą:

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

Taip animuojami visi puslapio .badge, kad ir kur jie būtų. Pakartotinai naudojamuose komponentuose verčiau rinkitės santykinius selektorius, nes globalus selektorius taip pat atitinka kitur puslapyje esančias komponento kopijas.

Apribojimai

Kiekvienas elementas turi vieną taikinį. Kai selektorius nurodytas keliuose segmentuose, paskutinis taikomas visoms elemento būsenoms. Čia ir from, ir to taikomi p, o ne h1:

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

Jei norite skirtingai animuoti dvi grupes, priskirkite utilitas patiems vaikiniams elementams arba sugrupuokite juos į laiko juostą.

Selektorius baigiasi ties pirmuoju ], todėl nepalaikomi selektoriai su laužtiniais skliaustais, pavyzdžiui, atributų selektoriai, kaip [&>[data-item]]. Vietoj jų naudokite klasės arba elemento selektorių.

Selektoriai sujungiami su lūžio taškais tokia tvarka, kokia aprašyta skiltyje Sintaksė, pavyzdžiui, @lg:[&>div]:from:opacity-0.