Animated.Value
用于驱动动画的标准值。一个 Animated.Value 可以同步驱动多个属性，但一次只能由一个机制驱动。使用新机制（例如启动新动画或调用 setValue）将停止之前的任何机制。
通常在类组件中通过 useAnimatedValue(0); 或 new Animated.Value(0); 初始化。
参考
方法
setValue()
tsx
setValue(value: number);
直接设置值。这将停止在该值上运行的任何动画并更新所有绑定属性。
参数
| 姓名 | 类型 | 必需 | 描述 |
|---|---|---|---|
| 值 | 数字 | 是 | 值 |
setOffset()
tsx
setOffset(offset: number);
设置一个偏移量，该偏移量将应用于通过 setValue、动画或 Animated.event 设置的任何值之上。这对于补偿平移手势的起始点等情况很有用。
参数
| 姓名 | 类型 | 必需 | 描述 |
|---|---|---|---|
| 偏移量 | 数字 | 是 | 偏移值 |
flattenOffset()
tsx
flattenOffset();
将偏移值合并到基值中并将偏移量重置为零。值的最终输出保持不变。
extractOffset()
tsx
extractOffset();
将偏移值设置为基值，并将基值重置为零。值的最终输出保持不变。
addListener()
tsx
addListener(callback: (state: {value: number}) => void): string;
向该值添加一个异步监听器，以便您可以观察动画的更新。这很有用，因为无法同步读取该值，因为它可能是由原生驱动的。
返回一个字符串作为监听器的标识符。
参数
| 姓名 | 类型 | 必需 | 描述 |
|---|---|---|---|
| 回调 | 函数 | 是 | 回调函数将接收一个对象，该对象具有一个设置为新值的 value 键。 |
removeListener()
tsx
removeListener(id: string);
注销监听器。 id 参数应与之前由 addListener() 返回的标识符匹配。
参数
| 姓名 | 类型 | 必需 | 描述 |
|---|---|---|---|
| ID | 字符串 | 是 | 要移除的监听器的 ID。 |
removeAllListeners()
tsx
removeAllListeners();
移除所有注册的监听器。
stopAnimation()
tsx
stopAnimation(callback?: (value: number) => void);
停止任何正在运行的动画或跟踪。 callback 在停止动画后使用最终值调用，这对于更新状态以使动画位置与布局匹配很有用。
参数
| 姓名 | 类型 | 必需 | 描述 |
|---|---|---|---|
| 回调 | 函数 | 否 | 一个将接收最终值的函数。 |
resetAnimation()
tsx
resetAnimation(callback?: (value: number) => void);
停止任何动画并将值重置为原始值。
参数
| 姓名 | 类型 | 必需 | 描述 |
|---|---|---|---|
| 回调 | 函数 | 否 | 一个将接收原始值的函数。 |
interpolate()
tsx
interpolate(config: InterpolationConfigType);
在更新属性之前插入值，例如将 0-1 映射到 0-10。
请参阅 AnimatedInterpolation.js
参数
| 姓名 | 类型 | 必需 | 描述 |
|---|---|---|---|
| 配置 | 对象 | 是 | 见下文。 |
config 对象包含以下键：
inputRange：一个数字数组outputRange：一个数字或字符串数组easing（可选）：一个函数，给定一个输入数字，返回一个数字extrapolate（可选）：一个字符串，例如 'extend'、'identity' 或 'clamp'extrapolateLeft（可选）：一个字符串，例如 'extend'、'identity' 或 'clamp'extrapolateRight（可选）：一个字符串，例如 'extend'、'identity' 或 'clamp'
animate()
tsx
animate(animation, callback);
通常仅供内部使用，但也可能由自定义动画类使用。
参数
| 姓名 | 类型 | 必需 | 描述 |
|---|---|---|---|
| 动画 | 动画 | 是 | 请参阅 Animation.js。 |
| 回调 | 函数 | 是 | 回调函数。 |