Files

390 lines
15 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 动画
动画就是一系列数据按照指定方式变化:位置、透明度、颜色与进度条长度,都可以随时间连续改变。曲线决定「时间从起点走到终点时,数据按什么方式变化」;把数据与曲线交给动画系统,值就会平滑过渡,而不是瞬间跳过去。
本篇先讲曲线如何把时间映射成数据,再按基础、缓动与双曲三组介绍内置曲线的参数与形状,最后讲三个高层接口 `transitioned`、`transitionedColor` 与 `cycledTransition`。更底层的执行器与激励源见渲染底层。
## 前置知识
阅读本篇前,建议先读完:
- [响应式](./reactivity.md)
- [UI 入门](../basics/ui-basics.md)
## 动画的本质与曲线
一个动画由两部分组成:一份要变化的数据,和一条把时间进度映射成数据取值的曲线。时间进度通常叫 `progress`,从 `0`(开始)走到 `1`(结束)。曲线接收 `progress`,返回一个数;动画系统按这个返回值,在起始值与目标值之间取出当前值。
```ts
type ExcitationCurve = (progress: number) => number;
```
`progress` 在 `0` 到 `1` 之间,曲线的输出不要求也落在 `0` 到 `1`:输出可以超出这个范围,所以过程中可以低于起始值或高于目标值,也可以多次起伏。曲线只决定过渡过程,不决定动画最终落在哪个值;最终落点由使用曲线的动画接口给出。
内置曲线都从 `@motajs/animate` 导入。不带 `mode` 参数的曲线直接返回一条固定形状的曲线;带 `mode` 参数的曲线会在内部套用下面的曲线模式。
## 曲线模式
曲线本身只保证「缓进快出」这一种基本形状。给它套一个 `CurveMode`,就能改变快慢分布。`CurveMode` 是曲线的模式枚举,默认 `CurveMode.EaseIn`。
| 模式 | 含义 | 形状 |
| ---------------------- | ---------------- | ------------------------------ |
| `CurveMode.EaseIn` | 缓进快出 | 从起点慢慢加速,越接近终点越快 |
| `CurveMode.EaseOut` | 快进缓出 | 起步快,接近终点逐渐减速 |
| `CurveMode.EaseInOut` | 缓进缓出,中间快 | 两端慢、中段最快 |
| `CurveMode.EaseCenter` | 快进快出,中间缓 | 两端快、中段最慢 |
这四种模式都从 `0` 开始、到 `1` 结束,区别只在过程中的快慢分布:`EaseIn` 越走越快,`EaseOut` 越走越慢,`EaseInOut` 两端慢、中段快,`EaseCenter` 两端快、中段慢。`CurveMode` 只改变形状,不改变时长与起止值;同一个曲线换模式只是让过程中快慢不同。各模式如何由一条缓进快出曲线换算得到,见[动画曲线](../internals/animation-curves.md#曲线模式)。
下面的演示用同一条正弦曲线,点四个按钮在四种模式之间切换。曲线连续变化,可以直观看出快慢分布。
<ClientOnly>
<RenderDemo :loader="curveModesLoader" :width="480" :height="320" />
<template #fallback>
渲染示例需要浏览器环境。
</template>
</ClientOnly>
## 内置曲线
下面按基础、缓动与双曲三组列出参数与形状;同一组的多条曲线画在一张图里,便于对照。
### 基础曲线
三条基础曲线不接收 `mode` 参数,形状直接由参数决定。
| 曲线 | 参数 |
| ------------- | --------------------- |
| `linear()` | 无 |
| `step(k)` | `k`:阶梯数,取正整数 |
| `constant(k)` | `k`:常数输出值 |
<ClientOnly>
<RenderDemo :loader="basicCurvesLoader" :width="480" :height="320" />
<template #fallback>
渲染示例需要浏览器环境。
</template>
</ClientOnly>
### 缓动曲线
四条曲线都以「缓进快出」为基准,并接收可选的 `mode`;不传时默认 `CurveMode.EaseIn`。它们从 `0` 上升到 `1`,上升速度不同。
| 曲线 | 参数 |
| ----------------- | ------------------------------------ |
| `sin(mode?)` | `mode` 可选,默认 `CurveMode.EaseIn` |
| `tan(mode?)` | `mode` 可选,默认 `CurveMode.EaseIn` |
| `sec(mode?)` | `mode` 可选,默认 `CurveMode.EaseIn` |
| `pow(exp, mode?)` | `exp` 必需,指数;`mode` 可选 |
<ClientOnly>
<RenderDemo :loader="easingCurvesLoader" :width="480" :height="320" />
<template #fallback>
渲染示例需要浏览器环境。
</template>
</ClientOnly>
### 双曲曲线
三条双曲曲线同样接收可选的 `mode`,默认 `CurveMode.EaseIn`。`k` 是比例参数。
| 曲线 | 参数 |
| -------------------- | -------------------------------------------- |
| `cosh(k = 2, mode?)` | `k` 默认 `2`;`mode` 默认 `CurveMode.EaseIn` |
| `tanh(k = 2, mode?)` | `k` 默认 `2`;`mode` 默认 `CurveMode.EaseIn` |
| `sech(k = 1, mode?)` | `k` 默认 `1`;`mode` 默认 `CurveMode.EaseIn` |
<ClientOnly>
<RenderDemo :loader="specialCurvesLoader" :width="480" :height="320" />
<template #fallback>
渲染示例需要浏览器环境。
</template>
</ClientOnly>
曲线公式、模式换算与单条曲线的行为见[动画曲线](../internals/animation-curves.md)。
## 数值渐变
界面里经常需要让一个数值在两次状态之间平滑变化,例如透明度从 `0.25` 到 `1`、圆点从左边移到右边。自己管理执行器、选择对象、绑定激励源会很啰嗦;`transitioned` 把这些收进一个控制器:你只需要告诉它「现在去哪个值」,它负责在当前值与目标值之间平滑推进。
### 获取控制器
先创建控制器,并给它一个初始值、一次变化默认用多久,以及过程中用哪条曲线:
```tsx
// setup
import { transitioned } from '@motajs/render-vue';
import { CurveMode, sin } from '@motajs/animate';
// 初始值 0.25,默认 600ms,曲线用 sin()
const alpha = transitioned(0.25, 600, sin(CurveMode.EaseOut))!;
```
`transitioned(value, time, curve)` 返回一个数值渐变控制器,类型是 `ITransitionedController<number> | null`:`value` 是初始值,`time` 是默认时长(毫秒),`curve` 是速率曲线。它只在组件 `setup` 中调用;在 `setup` 中返回值一定非空,所以这里用 `!` 收窄类型。返回的控制器带一个响应式引用 `ref`(类型 `Ref<number>`),渲染时读 `alpha.ref.value` 就能拿到当前值。
### 执行渐变动画
控制器拿到后,当前值就是初始值。要让数值走向新目标,调用 `set(value, time?)`;省略 `time` 时使用控制器的默认时长:
```tsx
// setup
const expand = () => {
// 从当前值走向 1,使用创建时的 600ms
alpha.set(1);
};
// 组件内容
<g-rect
loc={[40, 92, 120, 88]}
fillStyle="#2f6fed"
alpha={alpha.ref.value}
onClick={expand}
/>;
```
调用 `set(1)` 后,控制器从调用时的当前值出发,在 600ms 内走向 1;渲染函数读 `alpha.ref.value`,所以矩形的透明度会跟着变化。动画进行中再次 `set`,会从当时的当前值转向新目标;`time` 为 `0` 时直接落到目标值。
### 设置渐变参数
如果某一次变化想用不同节奏,或者之后都换一条曲线、一个时长,可以在下一次 `set` 前调用 `mode(curve)` 或 `setTime(time)`:
```tsx
// setup
import { linear } from '@motajs/animate';
// 这一次改用 300ms
alpha.set(0.4, 300);
// 之后的 set 都改用线性曲线与 1200ms
alpha.mode(linear());
alpha.setTime(1200);
```
`mode(curve)` 替换后续 `set` 使用的速率曲线;`setTime(time)` 替换后续 `set` 的默认时长。两者只影响之后的调用,不会重设当前正在进行的渐变。
把三步连起来,就是一次完整的数值渐变。下面的示例同时驱动透明度、位置与进度条:
```tsx
// setup
import { transitioned } from '@motajs/render-vue';
import { CurveMode, linear, sin } from '@motajs/animate';
const alpha = transitioned(0.25, 600, sin(CurveMode.EaseOut))!;
const slide = transitioned(0, 600, sin(CurveMode.EaseOut))!;
const bar = transitioned(0.3, 600, sin(CurveMode.EaseOut))!;
const expand = () => {
alpha.set(1);
slide.set(1, 300);
bar.set(1);
};
bar.mode(linear());
bar.setTime(1200);
// 组件内容
<g-rect loc={[40, 92, 120, 88]} fillStyle="#2f6fed" alpha={alpha.ref.value} />
<g-circle
circle={[204 + slide.ref.value * 192, 140, 12]}
fillStyle="#f2b84b"
/>
<g-rect
loc={[40, 234, 280 * bar.ref.value, 12]}
fillStyle="#7ee787"
/>
```
下面的 live 用三组元素展示 `alpha`、位置与进度条的渐变。
<ClientOnly>
<RenderDemo :loader="alphaLoader" :width="480" :height="320" />
<template #fallback>
渲染示例需要浏览器环境。
</template>
</ClientOnly>
## 颜色渐变
颜色字符串不能直接做数值加减;自己拆成红、绿、蓝、透明四个通道再分别推进,也很麻烦。`transitionedColor` 把颜色当作一个整体:它内部拆通道、同步推进,最后再拼回颜色字符串。
### 获取颜色控制器
```tsx
// setup
import { transitionedColor } from '@motajs/render-vue';
import { CurveMode, sin } from '@motajs/animate';
const fill = transitionedColor('#2f6fed', 600, sin(CurveMode.EaseOut))!;
```
`transitionedColor(color, time, curve)` 返回一个颜色渐变控制器,类型是 `ITransitionedController<string> | null`。`color` 是初始颜色,`time` 是默认时长,`curve` 是速率曲线。它返回的控制器与数值渐变同形,但 `ref.value` 是当前颜色字符串,可以直接交给 `fillStyle`、`strokeStyle`。
支持的颜色写法有十六进制 `#rgb`、`#rgba`、`#rrggbb`、`#rrggbbaa`,以及 `rgb(r, g, b)` 与 `rgba(r, g, b, a)`。只支持这些写法;其他格式不会按预期渐变。
### 执行颜色渐变
```tsx
// setup
const warm = () => {
fill.set('#f2b84b');
};
// 组件内容
<g-rect loc={[40, 80, 180, 140]} fillStyle={fill.ref.value} onClick={warm} />;
```
调用 `set` 后,控制器从当前颜色走向目标颜色;渲染函数读 `fill.ref.value` 得到中间颜色。`set`、`mode`、`setTime` 的用法与数值渐变一致。
### 设置颜色渐变参数
```tsx
// setup
import { linear } from '@motajs/animate';
// 这一次改用 300ms
fill.set('#7ee787', 300);
// 之后的 set 都改用线性曲线与 1200ms
fill.mode(linear());
fill.setTime(1200);
```
`set` 的第二个参数只覆盖这一次的时长;`mode` 与 `setTime` 改的是之后的调用。
把填充色与描边色放进同一个示例:
```tsx
// setup
import { transitionedColor } from '@motajs/render-vue';
import { CurveMode, sin } from '@motajs/animate';
const fill = transitionedColor('#2f6fed', 600, sin(CurveMode.EaseOut))!;
const stroke = transitionedColor(
'rgba(242, 184, 75, 0.9)',
600,
sin(CurveMode.EaseOut)
)!;
fill.set('#f2b84b');
stroke.set('#7ee787');
// 组件内容
<g-rect loc={[40, 80, 180, 140]} fillStyle={fill.ref.value} />
<g-circle
circle={[320, 150, 56]}
stroke
strokeStyle={stroke.ref.value}
lineWidth={10}
/>
```
下面的 live 同时渐变填充色与描边色。
<ClientOnly>
<RenderDemo :loader="colorLoader" :width="480" :height="320" />
<template #fallback>
渲染示例需要浏览器环境。
</template>
</ClientOnly>
## 循环渐变
呼吸灯、闪烁这类效果需要数值在两个端点之间反复往返。每次到端点都手动重设目标,很容易接不上;`cycledTransition` 把往返过程包成一个自动循环的控制器。
### 获取循环控制器
```tsx
// setup
import { cycledTransition } from '@motajs/render-vue';
import { CurveMode, sin } from '@motajs/animate';
// 在 0.25 与 1 之间往返,单程 900ms
const glow = cycledTransition(0.25, 1, 900, sin(CurveMode.EaseOut))!;
```
`cycledTransition(min, max, time, curve, maxStart = false)` 返回一个循环渐变控制器,类型是 `ICycledTransitionController | null`。`min` 与 `max` 是循环的两个端点,`time` 是单程耗时(毫秒),`curve` 是单程使用的速率曲线;`maxStart` 为 `true` 时从 `max` 开始,否则从 `min` 开始。控制器返回后会自动开始循环,组件卸载时停止,不需要手动清理。
### 读取循环值
循环已经自动开始,渲染时读 `glow.ref.value` 就能拿到当前值:
```tsx
// 组件内容
<g-circle circle={[180, 150, 80]} fillStyle="#2f6fed" alpha={glow.ref.value} />
```
这个圆形的透明度会在 0.25 与 1 之间反复变化。到端点后控制器会自动把目标切到另一端,不需要再调用 `set`。
### 设置循环参数
```tsx
// setup
import { linear } from '@motajs/animate';
const narrow = () => {
glow.setRange(0.5, 1);
};
glow.mode(linear());
glow.setTime(1200);
// 组件内容
<g-circle
circle={[180, 150, 80]}
fillStyle="#2f6fed"
alpha={glow.ref.value}
onClick={narrow}
/>;
```
`setRange(min, max)` 修改循环的两个端点,并立即按新区间重新确定这一次的目标;`mode(curve)` 与 `setTime(time)` 修改后续单程使用的曲线与时长。
把两个循环放进同一个示例:
```tsx
// setup
import { cycledTransition } from '@motajs/render-vue';
import { CurveMode, linear, sin } from '@motajs/animate';
const glow = cycledTransition(0.25, 1, 900, sin(CurveMode.EaseOut))!;
const core = cycledTransition(0.5, 1, 900, linear(), true)!;
const widen = () => {
glow.setRange(0.5, 1);
};
// 组件内容
<g-circle circle={[180, 150, 80]} fillStyle="#2f6fed" alpha={glow.ref.value} />
<g-circle circle={[180, 150, 38]} fillStyle="#f2b84b" alpha={core.ref.value} />
```
下面的 live 用两个滑动条分别调整循环的起点与终点,轨道上的圆点显示当前值。
<ClientOnly>
<RenderDemo :loader="cycleLoader" :width="480" :height="320" />
<template #fallback>
渲染示例需要浏览器环境。
</template>
</ClientOnly>
需要编排多对象、控制激励源或直接操作单个数值渐变时,继续读[动画曲线](../internals/animation-curves.md)、[动画激励](../internals/animation-excitation.md)、[动画执行器](../internals/animation-runner.md)与[渐变执行器](../internals/animation-transition.md)。
<script setup>
import RenderDemo from '../../.vitepress/components/renderDemo.vue';
const curveModesLoader = () =>
import('../../.vitepress/components/demos/ui/animation-curve-modes.tsx');
const basicCurvesLoader = () =>
import('../../.vitepress/components/demos/ui/animation-curves-basic.tsx');
const easingCurvesLoader = () =>
import('../../.vitepress/components/demos/ui/animation-curves-easing.tsx');
const specialCurvesLoader = () =>
import('../../.vitepress/components/demos/ui/animation-curves-special.tsx');
const alphaLoader = () =>
import('../../.vitepress/components/demos/ui/animation-alpha.tsx');
const colorLoader = () =>
import('../../.vitepress/components/demos/ui/animation-color.tsx');
const cycleLoader = () =>
import('../../.vitepress/components/demos/ui/animation-cycle.tsx');
</script>