Перейти до вмісту

Селектори

За замовчуванням Glaze шукає елементи з атрибутом data-animate і створює анімацію на основі значення цього атрибута. На цій сторінці описано три опції, які визначають, які елементи читає Glaze: dataAttribute, className і element, а також селектори у квадратних дужках, що спрямовують анімацію на інші елементи. Утиліти в рядку описано в розділі Синтаксис.

Як знаходяться елементи

Коли запускається glaze(), а також після кожного refresh() або перебудови в режимі спостереження, він обходить усі елементи в кореневому елементі й залишає ті, що мають налаштований атрибут або, у режимі класів, клас із налаштованим префіксом. Кореневий елемент також враховується, якщо має такий атрибут або клас. Елементи зчитуються в порядку документа.

Для кожного знайденого таким чином елемента створюється власна часова шкала, якщо тільки він не міститься в елементі tl або не пов’язаний із ним через tl:<id>. У такому разі його додають до тієї часової шкали. Докладніше про групування див. у розділі Часові шкали.

Власний атрибут

Використовуйте інший атрибут даних:

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

Тепер Glaze шукатиме data-move замість data-animate:

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

Параметр замінює атрибут, а не додає його. За наведеного вище налаштування елемент, який досі має data-animate, ігнорується. Використовуйте цей параметр, якщо інший скрипт на сторінці вже читає data-animate або якщо потрібно, щоб у розмітці атрибут мав назву вашого проєкту.

У режимі спостереження Glaze відстежує налаштований атрибут, тож зміна значення data-move в елементі планує повторну збірку.

Синтаксис на основі класів

Віддаєте перевагу класам замість атрибутів даних? Увімкніть режим класів:

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

Тепер анімації можна задавати як класи:

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

Це добре працює, якщо ви вже використовуєте підхід CSS utility-first і хочете, щоб анімації були схожими. Режим класів також корисний, коли система шаблонів дає змогу додавати класи до елемента, але не довільні атрибути.

Glaze зчитує кожен клас, що починається з префікса, за яким іде дефіс (тут це animate-), і видаляє цю частину. Класи без префікса залишаються без змін, тож класи анімації можуть стояти поруч із класами стилів на тому самому елементі. Анімацію можна розбити на кілька класів:

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

Адаптивні класи приймають контрольну точку як після префікса, так і перед ним. Обидва варіанти спрацьовують лише тоді, коли відповідає lg контрольна точка:

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

Набори налаштувань працюють у класах так само, наприклад animate-preset-fadeIn.

Режим класів не вимикає атрибут даних. Якщо елемент має обидва варіанти, Glaze об’єднує їх в один рядок: спочатку значення атрибута, а потім класи з префіксом у порядку їхньої появи в атрибуті class.

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

Цей елемент анімується від opacity: 0 протягом однієї секунди за будь-якого розміру, а також від y: 50, коли відповідає lg. Оскільки рядки об’єднуються, діє те саме правило, що й в одному рядку: якщо дві частини задають ту саму властивість, перемагає пізніша. Тут значення класу перевизначає значення атрибута для x:

HTML
<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, щоб анімувати лише елементи всередині контейнера:

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

element приймає Element або Document. Він обмежує три речі:

  • На наявність засобів анімації скануються лише кореневий елемент і його нащадки. Елементи в інших місцях сторінки ігноруються, навіть якщо мають data-animate.
  • Режим спостереження відстежує зміни лише всередині кореневого елемента.
  • destroy() видаляє лише те, що створив цей екземпляр, тож анімації інших частин сторінки залишаються.

Тому element варто використовувати в компонентних фреймворках. Створюйте окремий екземпляр для кожного змонтованого компонента, передаючи кореневий елемент компонента, і викликайте destroy() під час його демонтування, як показано в розділі Оновлення й очищення. Для окремих екземплярів задавайте кореневі елементи, які не перетинаються: елемент усередині двох кореневих елементів анімується обома екземплярами.

Вибір інших елементів

Наведені вище параметри визначають, які елементи зчитує Glaze. Селектор у квадратних дужках на початку сегмента визначає, до яких елементів застосовується анімація. Якщо його немає, анімується елемент із цими засобами.

Відносні селектори

Селектор, що починається з &, визначається відносно самого елемента, де & означає цей елемент. Для пошуку використовується querySelectorAll, тому можна знайти кілька елементів:

HTML
<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 всередині елемента на будь-якому рівні вкладеності:

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

Кожне підкреслення в селекторі перетворюється на пробіл, тому таким способом не можна знайти назву класу, що містить підкреслення.

[&] без додаткових символів відповідає самому елементу. Його здебільшого використовують як значення, наприклад scrollTrigger.trigger-[&] у значеннях за замовчуваннямScrollTrigger і значеннях за замовчуваннямшкали часу.

Глобальні селектори

Селектор без & передається механізму анімації як рядок. GSAP і Motion визначають відповідні елементи в усьому документі, а не лише в елементі чи кореневому елементі element:

HTML
<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:

HTML
<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.