Перейти к содержимому

Значения по умолчанию

Задайте значения по умолчанию один раз в том же вызове glaze(), что и конфигурацию движка. Собственные утилиты элемента переопределяют совпадающие значения по умолчанию.

Значения элементов по умолчанию

Свойства без указания состояния применяются ко всем существующим состояниям анимации from или to:

TypeScript
glaze({
  lib: { gsap: { core: gsap } },
  defaults: { element: "duration-1|ease-power2.inOut" },
})
HTML
<!-- Uses a one-second duration and the default easing. -->
<div data-animate="from:opacity-0"></div>

<!-- Explicit values win over defaults. -->
<div data-animate="from:opacity-0|duration-0.5"></div>

Значения по умолчанию для конкретного состояния применяются только к нему:

TypeScript
defaults: {
  element: "duration-1 from:opacity-0 to:ease-linear",
}

Анимация to получает общую длительность и функцию плавности to, но состояние from не добавляется. Значения по умолчанию никогда не создают состояние анимации, которое элемент не запросил. Для анимации from/to общие значения по умолчанию применяются к обоим состояниям, затем — значения для конкретного состояния, а после них — явно заданные значения элемента.

Устаревший ключ конфигурации elementSettings по-прежнему служит псевдонимом общих значений по умолчанию. В новом коде используйте element; если для одного значения заданы оба ключа, приоритет у element.

Значения временной шкалы по умолчанию

Используйте defaults.tl для настроек всех таймлайнов:

TypeScript
glaze({
  lib: { gsap: { core: gsap } },
  defaults: {
    tl: "defaults:ease-power2.inOut|duration-1",
  },
})

Glaze создает таймлайн даже для отдельных анимированных элементов. Значения из defaults: передаются движку в качестве значений таймлайна по умолчанию. Свойства элемента по-прежнему имеют приоритет. Собственные настройки таймлайна переопределяют сконфигурированные значения, сохраняя те значения по умолчанию, которые они не заменяют.

Для вложенных свойств в настройках таймлайна используется двоеточие:

TypeScript
defaults: {
  tl: "defaults:duration-1 scrollTrigger:trigger-[&]",
}

Здесь [&] соответствует элементу, которому принадлежит таймлайн. Для ScrollTrigger требуются GSAP и зарегистрированный плагин ScrollTrigger. Адаптер Motion явно отклоняет настройки только для GSAP.