跳转到正文

断点

Glaze 会通过所选适配器响应媒体查询变化。GSAP 使用其 matchMedia 上下文;Motion 使用原生媒体查询监听器。匹配的查询发生变化时,两者都会重建动画并清理之前的样式。

设置

在配置中定义断点:

JavaScript
glaze({
  lib: { gsap: { core: gsap } },
  breakpoints: {
    default: "(min-width: 1px)",
    sm: "(min-width: 640px)",
    md: "(min-width: 768px)",
    lg: "(min-width: 1024px)",
  },
})

未指定其他断点时,将运行 default 断点。如果没有设置,它默认为 (min-width: 1px)。

default 是 Glaze 自带的唯一断点。其他名称(如 sm 或 lg)只有在此处定义后才能使用。使用未定义断点的动画片段会被忽略,且不会发出警告。因此,如果只定义了 lg,却误写成 @xl:,该动画就会被静默跳过。

用法

在动画前添加 @breakpoint::

HTML
<div
  class="h-20 w-20 rounded-xl bg-lime-500"
  data-animate="@lg:from:opacity-0|rotate-180|duration-1"
></div>
HTML
<div
  class="h-20 w-20 rounded-xl bg-lime-500 lg:invisible"
  data-animate="@lg:from:duration-1|autoAlpha-0|rotate-360|xPercent-[-100]|ease-power2.inOut|scrollTrigger.trigger-[&]"
></div>

此动画仅在 lg 屏幕(1024px+)上运行。

多个断点

用空格分隔多个断点即可将它们叠加使用:

HTML
<div data-animate="@sm:from:opacity-0|y-50 @lg:from:scale-0.5"></div>

在小屏幕上,元素会从下方淡入。在大屏幕上,还会放大。

HTML
<div
  class="h-20 w-20 rounded-xl bg-orange-500 lg:invisible"
  data-animate="@sm:from:duration-1|autoAlpha-0|rotate-360|xPercent-[-100]|ease-power2.inOut|scrollTrigger.trigger-[&] @lg:from:background-[red]"
></div>

这些动画会组合起来:每个媒体查询匹配的断点都会贡献其属性。如果两个匹配的断点设置了相同属性,则字符串中靠后的设置生效,与屏幕尺寸无关。像上面这样,按从小到大的顺序编写断点,这样较大的断点就会覆盖较小的断点。