Ugrás a tartalomhoz

Szelektorok

Alapértelmezés szerint a Glaze olyan elemeket keres, amelyek rendelkeznek a data-animate attribútummal, és az attribútum értéke alapján építi fel az animációt. Ez az oldal azt a három beállítást ismerteti, amelyek megváltoztatják, hogy a Glaze mit olvas be: a dataAttribute, a className és a element beállítást, valamint azokat a szögletes zárójeles szelektorokat, amelyek más elemekre irányítják az animációt. A sztringben szereplő segédosztályokat a Szintaxis rész ismerteti.

Hogyan találja meg az elemeket

A glaze() futásakor, majd minden refresh() vagy figyelő módban végzett újraépítéskor végigjárja a gyökérelemen belüli összes elemet, és megtartja azokat, amelyek rendelkeznek a konfigurált attribútummal, vagy osztálymódban olyan osztállyal, amelynek előtagja a beállított előtag. A gyökérelem is számít, ha rendelkezik ilyennel. Az elemek beolvasása dokumentumsorrendben történik.

Az így megtalált minden elem saját idővonalat kap, kivéve, ha egy tl elem belsejében van, vagy a tl:<id> segítségével egy ilyen elemhez kapcsolódik. Ilyenkor ehelyett annak az idővonalához kerül. A csoportosítás működéséről az Idővonalak részben olvashat.

Egyéni attribútum

Használjon másik adatattribútumot:

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

Ettől kezdve a Glaze a data-animate helyett a data-move értékét keresi:

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

A beállítás lecseréli az attribútumot, nem pedig hozzáad egyet. A fenti beállítással figyelmen kívül marad az az elem, amelyen továbbra is szerepel a data-animate. Akkor használja, ha az oldalon egy másik szkript már a data-animate értékét olvassa, vagy ha azt szeretné, hogy a projektjéhez illő nevet kapjon a markup attribútuma.

figyelési módban a Glaze a beállított attribútumot figyeli, ezért az elem data-move értékének módosítása újraépítést ütemez be.

Osztályalapú szintaxis

Inkább osztályokat használna adatattribútumok helyett? Engedélyezze az osztálymódot:

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

Ezután az animációkat osztályként írhatja meg:

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

Ez jól működik, ha már használ utility-first CSS megközelítést, és azt szeretné, hogy az animációi hasonló hatást keltsenek. Az osztálymód akkor is hasznos, ha egy sablonrendszerben hozzáadhat osztályokat az elemekhez, de tetszőleges attribútumokat nem.

A Glaze minden olyan osztályt beolvas, amely az előtaggal és egy kötőjellel kezdődik (itt: animate-), majd eltávolítja ezt a részt. Az előtag nélküli osztályok érintetlenek maradnak, így az animációs osztályok ugyanazon az elemen a stílusosztályok mellett is szerepelhetnek. Az animáció több osztályra is felosztható:

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

A reszponzív osztályoknál a töréspont az előtag után és előtt is megadható. Mindkét változat csak akkor fut le, ha egyezik a lg töréspont:

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

Az Előbeállítások osztályokban is ugyanígy működnek, például animate-preset-fadeIn.

Az osztálymód nem kapcsolja ki az adat attribútumot. Ha egy elem mindkettővel rendelkezik, a Glaze egyetlen karakterlánccá fűzi össze őket: először az attribútum értéke következik, majd az előtaggal ellátott osztályok a class attribútumban szereplő sorrendben.

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

Ez az elem minden méretben egy másodperc alatt a opacity: 0 állapotból animálódik, és akkor is a y: 50 állapotból, ha egyezik a lg. Mivel a karakterláncok össze vannak fűzve, ugyanaz a szabály érvényes, mint egyetlen karakterláncon belül: ha két rész ugyanazt a tulajdonságot állítja be, a későbbi érték érvényesül. Itt az osztály értéke felülírja az attribútum értékét ennél: x

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

Az elem a x: 100 és a y: 20 állapotba animálódik.

Ha az watch engedélyezve van osztálymódban, az Glaze az class változásait is figyeli. Ha egy elemhez animate- osztályt ad, vagy megváltoztatja egy olyan elem osztályait, amelyet az Glaze már olvas vagy animál, újraépítés ütemeződik. Egy relatív szelektort tartalmazó elem esetén a leszármazottain végzett osztálymódosítások is újraépítést váltanak ki, mivel megváltoztathatják, mire illeszkedik a szelektor. Más elemeken végzett osztálymódosítások nem váltanak ki újraépítést; ez az animált elemek őseire is igaz. Így ha a <html> elemre sötét módot jelző osztályt, vagy a <body> elemre görgetést letiltó osztályt kapcsol, azzal nem zavarja meg a futó animációkat. Azt sem veszi észre, ha egy osztálymódosítás miatt egy elem újonnan illeszkedik egy globális szelektorra; ilyenkor hívja meg az refresh() függvényt.

A Glaze alapértelmezés szerint a teljes document területén keres. Adja át a element értéket, ha csak egy tárolón belüli elemeket szeretne animálni:

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

A element egy Element vagy egy Document értéket fogad el. Három dolgot korlátoz:

  • Animációs segédosztályokat csak a gyökérelem és leszármazottai között keres. Az oldal más részein lévő elemeket figyelmen kívül hagyja, még akkor is, ha szerepel rajtuk a data-animate.
  • Figyelési módban csak a gyökérelemen belüli változásokat követi.
  • A destroy() csak az általa létrehozott elemeket takarítja el, így az oldal más részein az animációk megmaradnak.

Ezért a element különösen hasznos komponenskeretrendszerekben. Minden csatlakoztatott komponenshez hozzon létre egy példányt a komponens gyökérelemével, majd leválasztáskor hívja meg a destroy() függvényt, ahogy az a Frissítés és eltakarítás részben látható. Az egyes példányokhoz olyan gyökérelemeket adjon meg, amelyek nem fedik egymást; a két gyökérelemben is szereplő elemet mindkét példány animálja.

Más elemek célzása

A fenti beállítások határozzák meg, hogy a Glaze mely elemeket olvassa be. A szegmens elején megadott szögletes zárójelű szelektor dönti el, hogy mely elemekre kerül az animáció. Ha nincs ilyen, az animáció azokra az elemekre vonatkozik, amelyeken a segédosztályok szerepelnek.

Relatív szelektorok

A & kezdetű szelektor feloldása magából az elemből indul ki, ahol a & az adott elemet jelöli. A rendszer a querySelectorAll segítségével kérdezi le, ezért több elemet is találhat:

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

A [&>li] a közvetlen li gyermekelemekre illeszkedik. A stagger érték 0,1 másodperces eltérésekkel indítja őket. Akkor használja, ha egy elemnek egy lista, rács vagy gyermekelemekből álló csoport animációját kell vezérelnie, anélkül hogy minden gyermekhez attribútumot adna.

A szóközöket aláhúzásjelekkel írja. A [&_p] így & p lesz, és az elem bármely mélységben lévő összes p elemére illeszkedik:

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

A szelektorban minden aláhúzásjel szóközzé alakul, ezért az aláhúzásjelet tartalmazó osztálynév így nem illeszthető.

A [&] önmagában az elemet jelöli. Leginkább értékként használatos, például scrollTrigger.trigger-[&] a ScrollTrigger és az idővonal defaults esetén.

Globális szelektorok

A & nélküli szelektort az animációs motor karakterláncként kapja meg. A GSAP és a Motion a teljes dokumentum alapján oldja fel, nem az elem vagy a element gyökérelem alapján:

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

Ez az oldal minden .badge elemét animálja, bárhol is legyen. Újrahasználható komponenseknél inkább relatív szelektorokat használjon, mert egy globális szelektor az oldal más részein lévő komponenspéldányokat is eléri.

Korlátok

Minden elemnek egy célpontja van. Ha több szegmens is tartalmaz szelektort, az utolsó vonatkozik az elem összes állapotára. Itt a from és a to is a p elemre vonatkozik, nem a h1 elemre:

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

Ha két csoportot különbözően szeretne animálni, helyezze a segédosztályokat magukra a gyermekelemekre, vagy csoportosítsa őket egy idővonal segítségével.

A szelektor az első ] jelnél véget ér, ezért a zárójelet tartalmazó szelektorok, például az olyan attribútumszelektorok, mint a [&>[data-item]], nem támogatottak. Helyette használjon osztály- vagy elemeket kijelölő szelektort.

A szelektorok és a töréspontok az Szintaxis részben leírt sorrendben kapcsolhatók össze, például így: @lg:[&>div]:from:opacity-0.