Селектори
По подразбиране Glaze търси елементи с атрибута data-animate и изгражда анимацията според стойността на този атрибут. Тази страница разглежда трите опции, които променят кои елементи чете Glaze: dataAttribute, className и element, както и селекторите в квадратни скоби, които насочват анимацията към други елементи. Помощните средства в низа са описани в Синтаксис.
Как се намират елементите
Когато се изпълни glaze(), а също и при всяко refresh() или повторно изграждане в режим на наблюдение, той обхожда всички елементи в кореновия елемент и оставя само тези със зададения атрибут или, в режим на класове, с клас и зададения префикс. Кореновият елемент също се взема предвид, ако има такъв атрибут или клас. Елементите се прочитат в реда им в документа.
Всеки намерен по този начин елемент получава собствена времева линия, освен ако не е вложен в елемент tl или не препраща към такъв с tl:<id>. В такъв случай той се добавя към същата времева линия. Вижте Времеви линии, за да научите как работи групирането.
Персонализиран атрибут
Използвайте друг атрибут за данни:
glaze({
lib: { gsap: { core: gsap } },
dataAttribute: "data-move",
})
Сега Glaze ще търси data-move вместо data-animate:
<div data-move="from:opacity-0"></div>
Опцията заменя атрибута, вместо да добавя нов. С настройката по-горе елемент, който все още има data-animate, се игнорира. Използвайте я, когато друг скрипт на страницата вече чете data-animate или когато искате маркировката да използва името на атрибута от вашия проект.
В режим наблюдение Glaze следи конфигурирания атрибут, така че промяна на стойността на data-move в елемент задейства повторно изграждане.
Синтаксис с класове
Предпочитате класове пред атрибути за данни? Включете режима с класове:
glaze({
lib: { gsap: { core: gsap } },
className: "animate",
})
Сега можете да задавате анимации като класове:
<div class="animate-from:opacity-0|duration-1"></div>
Това работи добре, ако вече използвате подхода utility-first с CSS и искате анимациите ви да имат подобно усещане. Режимът с класове е полезен и когато системата за шаблони ви позволява да добавяте класове към елемент, но не и произволни атрибути.
Glaze чете всеки клас, който започва с префикса, последван от тире (тук animate-), и премахва тази част. Класовете без префикса се оставят без промяна, така че класовете за анимация могат да стоят до класовете за стил на същия елемент. Можете да разделите анимацията между няколко класа:
<div class="card animate-from:opacity-0 animate-from:y-24"></div>
Адаптивните класове приемат точката на прекъсване след или преди префикса. И двата варианта се изпълняват само когато съвпада lg точката на прекъсване:
<div class="animate-@lg:from:opacity-0"></div>
<div class="@lg:animate-from:opacity-0"></div>
Предварително зададените стойности работят по същия начин и в класове, например animate-preset-fadeIn.
Режимът с класове не изключва атрибута за данни. Когато елементът има и двете, Glaze ги обединява в един низ: първо стойността на атрибута, след това класовете с префикс в реда, в който се появяват в атрибута class.
<div
class="animate-from:opacity-0 animate-@lg:from:y-50"
data-animate="from:duration-1"
></div>
Този елемент се анимира от opacity: 0 за една секунда при всеки размер, а също и от y: 50, когато съвпада lg. Тъй като низовете се обединяват, важи същото правило като в един низ: когато две части задават едно и също свойство, по-късната има предимство. Тук стойността на класа заменя стойността на атрибута за x:
<div class="animate-to:x-100" data-animate="to:x-50|y-20"></div>
Елементът се анимира до x: 100 и y: 20.
Когато watch е активиран в режим на класове, Glaze следи и промените в class. Добавянето на клас animate- към елемент или промяната на класовете на елемент, който Glaze вече отчита или анимира, планира повторно изграждане. Промените в класовете на потомците на елемент със селектор за относително съвпадение също го правят, защото могат да променят съвпаденията на селектора. Промените в класовете на други елементи не го правят, включително при предците на анимирани елементи. Затова превключването на клас за тъмен режим на <html> или на клас за заключване на превъртането на <body> не засяга текущите анимации. Промяна на клас, която кара елемент да съвпадне с глобален селектор, също не се открива; извикайте refresh() след нея.
Ограничаване на търсенето
Glaze търси в целия document по подразбиране. Подайте element, за да анимирате само елементи в контейнер:
glaze({
lib: { gsap: { core: gsap } },
element: document.querySelector("#app"),
})
element приема Element или Document. То ограничава три неща:
- За анимационни помощни класове се сканират само кореновият елемент и неговите наследници. Елементите другаде на страницата се игнорират, дори когато имат
data-animate. - Режимът на наблюдение следи само промените в кореновия елемент.
destroy()премахва само създаденото от тази инстанция, така че анимациите в другите части на страницата остават.
Така element е подходящата опция за компонентни рамки. Създавайте по една инстанция за всеки монтиран компонент, като ѝ подавате кореновия елемент на компонента, и извиквайте destroy() при демонтирането му, както е показано в Обновяване и почистване. Задавайте на отделните инстанции коренови елементи, които не се припокриват; елемент в два корена се анимира и от двете инстанции.
Насочване към други елементи
Опциите по-горе определят кои елементи чете Glaze. Селектор в квадратни скоби в началото на сегмент определя към кои елементи се прилага анимацията. Ако няма такъв, анимацията е насочена към елемента, който съдържа помощните класове.
Относителни селектори
Селектор, започващ с &, се разрешава спрямо самия елемент, като & обозначава този елемент. Заявката се изпълнява с querySelectorAll, затова могат да съвпаднат няколко елемента:
<ul data-animate="[&>li]:from:opacity-0|y-20|stagger-0.1">
<li>One</li>
<li>Two</li>
<li>Three</li>
</ul>
[&>li] съвпада с преките деца li. Стойността stagger раздалечава началните им времена с 0.1 секунди. Използвайте това, когато един елемент трябва да управлява анимацията на списък, мрежа или група от деца, без да добавяте атрибут към всяко дете.
Записвайте интервалите като долни черти. [&_p] става & p и съвпада с всеки p във вътрешността на елемента, на всякаква дълбочина:
<article data-animate="[&_p]:from:opacity-0|stagger-0.2">
<p>First paragraph</p>
<div><p>Nested paragraph</p></div>
</article>
Всяка долна черта в селектор се преобразува в интервал, така че по този начин не може да се намери клас, чието име съдържа долна черта.
Самостоятелно [&] се разрешава до самия елемент. Използва се предимно като стойност, например scrollTrigger.trigger-[&] в ScrollTrigger и настройките по подразбиране за времева линия defaults.
Глобални селектори
Селектор без & се подава като низ към анимационния енджин. GSAP и Motion го разрешават спрямо целия документ, а не спрямо елемента или кореновия елемент element:
<h2 data-animate="[.badge]:from:opacity-0|scale-0.5|duration-0.3">Inbox</h2>
<span class="badge">3</span>
Това анимира всеки .badge на страницата, независимо къде се намира. Предпочитайте относителни селектори в компоненти за многократна употреба, защото глобалният селектор съвпада и с копия на компонента в други части на страницата.
Ограничения
Всеки елемент има една цел. Когато няколко сегмента съдържат селектор, последният се прилага към всички състояния на елемента. Тук и from, и to се прилагат към p, а не към h1:
<div data-animate="[&>h1]:from:opacity-0 [&>p]:to:x-20">
<h1>Title</h1>
<p>Text</p>
</div>
За да анимирате две групи по различен начин, поставете помощните класове върху самите деца или ги групирайте във времева линия.
Селекторът завършва при първата ], затова не се поддържат селектори, съдържащи квадратни скоби, като селектори на атрибути от вида [&>[data-item]]. Вместо това използвайте селектор за клас или елемент.
Селекторите се комбинират с точките на прекъсване в реда, описан в Синтаксис, например @lg:[&>div]:from:opacity-0.