Selektory
Predvolene Glaze vyhľadáva prvky s atribútom data-animate a zostavuje animáciu podľa hodnoty tohto atribútu. Táto stránka opisuje tri možnosti, ktoré menia, ktoré prvky Glaze číta: dataAttribute, className a element, ako aj selektory v hranatých zátvorkách, ktoré nasmerujú animáciu na iné prvky. Pomocné triedy v reťazci opisuje časť Syntax.
Ako sa vyhľadávajú prvky
Pri spustení glaze() a znova pri každom opätovnom zostavení refresh() alebo v režime sledovania prejde všetky prvky v koreňovom prvku a ponechá tie, ktoré majú nakonfigurovaný atribút alebo v režime tried triedu s nakonfigurovaným prefixom. Počíta sa aj samotný koreňový prvok, ak má daný atribút alebo triedu. Prvky sa načítajú v poradí dokumentu.
Každý takto nájdený prvok dostane vlastnú časovú os, pokiaľ sa nenachádza vo vnútri prvku tl alebo naň neodkazuje pomocou tl:<id>. V takom prípade sa namiesto toho pridá do danej časovej osi. Spôsob zoskupovania nájdete v časti Časové osi.
Vlastný atribút
Použite iný dátový atribút:
glaze({
lib: { gsap: { core: gsap } },
dataAttribute: "data-move",
})
Teraz bude Glaze hľadať data-move namiesto data-animate:
<div data-move="from:opacity-0"></div>
Táto možnosť atribút nahrádza, namiesto toho, aby pridala ďalší. Pri nastavení uvedenom vyššie sa prvok, ktorý stále obsahuje data-animate, ignoruje. Použite ju, ak iný skript na stránke už číta data-animate alebo ak chcete, aby názov atribútu v značke zodpovedal vášmu projektu.
V režime sledovania Glaze sleduje nakonfigurovaný atribút, takže zmena hodnoty data-move na prvku naplánuje opätovné zostavenie.
Syntax založená na triedach
Uprednostňujete triedy pred dátovými atribútmi? Zapnite režim tried:
glaze({
lib: { gsap: { core: gsap } },
className: "animate",
})
Teraz môžete zapisovať animácie ako triedy:
<div class="animate-from:opacity-0|duration-1"></div>
Funguje to dobre, ak už používate prístup CSS založený na utilitách a chcete, aby vaše animácie pôsobili podobne. Režim tried je užitočný aj vtedy, keď vám šablónovací systém umožňuje pridávať prvku triedy, ale nie ľubovoľné atribúty.
Glaze načíta každú triedu, ktorá začína predponou nasledovanou pomlčkou (tu animate-), a túto časť odstráni. Triedy bez predpony ponechá bez zmeny, takže animačné triedy môžu byť na tom istom prvku vedľa štýlovacích tried. Animáciu môžete rozdeliť medzi viacero tried:
<div class="card animate-from:opacity-0 animate-from:y-24"></div>
Responzívne triedy môžu mať zarážku buď za predponou, alebo pred ňou. Obe tieto možnosti sa spustia iba vtedy, keď sa zhoduje lg zarážka:
<div class="animate-@lg:from:opacity-0"></div>
<div class="@lg:animate-from:opacity-0"></div>
Predvoľby fungujú v triedach rovnako, napríklad animate-preset-fadeIn.
Režim tried nevypína dátový atribút. Keď má prvok oboje, Glaze ich spojí do jedného reťazca: najprv hodnotu atribútu a potom predponové triedy v poradí, v akom sa nachádzajú v atribúte class.
<div
class="animate-from:opacity-0 animate-@lg:from:y-50"
data-animate="from:duration-1"
></div>
Tento prvok sa pri každej veľkosti animuje z opacity: 0 počas jednej sekundy a tiež z y: 50, keď sa zhoduje lg. Keďže sa reťazce spájajú, platí rovnaké pravidlo ako v rámci jedného reťazca: ak dve časti nastavia tú istú vlastnosť, prednosť má tá neskoršia. Tu hodnota triedy prepisuje hodnotu atribútu pre x:
<div class="animate-to:x-100" data-animate="to:x-50|y-20"></div>
Prvok sa animuje do stavu x: 100 a y: 20.
Keď je v režime tried zapnutý watch, Glaze sleduje aj zmeny class. Pridanie triedy animate- k prvku alebo zmena tried prvku, ktorý už Glaze číta alebo animuje, naplánuje opätovné zostavenie. Zmeny tried potomkov prvku s relatívnym selektorom majú rovnaký účinok, pretože môžu zmeniť to, čomu selektor vyhovuje. Zmeny tried iných prvkov opätovné zostavenie nevyvolajú; to platí aj pre predkov animovaných prvkov, takže prepnutie triedy tmavého režimu na <html> alebo triedy uzamknutia posúvania na <body> neovplyvní prebiehajúce animácie. Nezachytí sa ani zmena triedy, po ktorej prvok začne vyhovovať globálnemu selektoru; potom zavolajte refresh().
Obmedzenie vyhľadávania
Glaze štandardne prehľadáva celý document. Ak chcete animovať iba prvky v kontajneri, odovzdajte element:
glaze({
lib: { gsap: { core: gsap } },
element: document.querySelector("#app"),
})
element prijíma Element alebo Document. Obmedzuje tri veci:
- Animačné utility sa vyhľadávajú iba v koreňovom prvku a jeho potomkoch. Prvky inde na stránke sa ignorujú, aj keď obsahujú
data-animate. - Režim sledovania sleduje zmeny iba vo vnútri koreňového prvku.
destroy()odstraňuje iba to, čo vytvorila táto inštancia, takže animácie v ostatných častiach stránky zostanú zachované.
Vďaka tomu je element vhodnou voľbou pre komponentové frameworky. Vytvorte jednu inštanciu pre každý pripojený komponent s koreňovým prvkom daného komponentu a pri jeho odpojení zavolajte destroy(), ako je uvedené v časti Obnovenie a vyčistenie. Samostatným inštanciám priraďte neprekrývajúce sa korene; prvok vo vnútri dvoch koreňov animujú obe inštancie.
Zameranie na iné prvky
Vyššie uvedené možnosti určujú, ktoré prvky Glaze načíta. Selektor v hranatých zátvorkách na začiatku segmentu určuje, na ktoré prvky sa animácia použije. Ak tam nie je, animácia sa zameria na prvok, ktorý obsahuje utility.
Relatívne selektory
Selektor začínajúci sa na & sa vyhodnotí vzhľadom na samotný prvok, pričom & označuje tento prvok. Vyhľadáva sa pomocou querySelectorAll, takže môže zodpovedať viacerým prvkom:
<ul data-animate="[&>li]:from:opacity-0|y-20|stagger-0.1">
<li>One</li>
<li>Two</li>
<li>Three</li>
</ul>
[&>li] zodpovedá priamym potomkom li. Hodnota stagger rozloží ich časy spustenia s odstupom 0,1 sekundy. Použite to, keď má jeden prvok ovládať animáciu zoznamu, mriežky alebo skupiny potomkov bez pridania atribútu ku každému potomkovi.
Medzery zapisujte ako podčiarkovníky. [&_p] sa zmení na & p a zodpovedá každému p vnútri prvku v ľubovoľnej hĺbke:
<article data-animate="[&_p]:from:opacity-0|stagger-0.2">
<p>First paragraph</p>
<div><p>Nested paragraph</p></div>
</article>
Každý podčiarkovník v selektore sa zmení na medzeru, takže týmto spôsobom nemožno vyhľadať názov triedy, ktorý obsahuje podčiarkovník.
Samotné [&] sa vyhodnotí ako samotný prvok. Používa sa najmä ako hodnota, napríklad scrollTrigger.trigger-[&] v ScrollTrigger a predvolené nastavenia časovej osi.
Globálne selektory
Selektor bez & sa odovzdá animačnému nástroju ako reťazec. GSAP a Motion ho vyhodnotia vzhľadom na celý dokument, nie vzhľadom na prvok ani koreň element:
<h2 data-animate="[.badge]:from:opacity-0|scale-0.5|duration-0.3">Inbox</h2>
<span class="badge">3</span>
Týmto sa animuje každý .badge na stránke bez ohľadu na jeho umiestnenie. V opakovane použiteľných komponentoch uprednostnite relatívne selektory, pretože globálny selektor zasiahne aj ďalšie kópie komponentu na stránke.
Obmedzenia
Každý prvok má jeden cieľ. Ak selektor obsahuje viacero segmentov, posledný sa použije na všetky stavy prvku. Tu sa na p použijú from aj to, nie na h1:
<div data-animate="[&>h1]:from:opacity-0 [&>p]:to:x-20">
<h1>Title</h1>
<p>Text</p>
</div>
Ak chcete animovať dve skupiny odlišne, umiestnite utility priamo na potomkov alebo ich zoskupte do časovej osi.
Selektor sa končí pri prvej ], preto selektory obsahujúce hranaté zátvorky, ako napríklad atribútové selektory [&>[data-item]], nie sú podporované. Použite namiesto nich selektor triedy alebo prvku.
Selektory sa kombinujú so zarážkami v poradí opísanom v časti Syntax, napríklad @lg:[&>div]:from:opacity-0.