Селекторы
По умолчанию 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>
Это хорошо подходит, если вы уже используете подход CSS utility-first и хотите, чтобы анимации выглядели похожим образом. Режим классов также полезен, если система шаблонов позволяет добавлять элементу классы, но не произвольные атрибуты.
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
и в значениях по умолчанию для временной шкалы.
Глобальные селекторы
Селектор без & передается механизму анимации в виде строки. 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.