@[toc]
API
react-spring库中与动画相关的API支持两种不同的使用渲染道具和react钩子的方法。接下来，我们将介绍react hook的一些动画相关API：
react spring hook创建的spring动画的基本配置可以通过usestate、useref等进行外部控制，以更改动画。动画过渡属性（从、到）也可以设置为状态控制，但无法实现过渡效果，并且变换非常严格
动画定义API（负责创建动画）
Usespring：创建一个简单的动画弹簧
使用弹簧：创建一组同时执行的弹簧
Usetrail：创建一组按顺序执行的弹簧（创建的弹簧属性一致）
使用转换：在生命周期发生变化时添加动画，如已安装/未安装的组件
Usechain：用于自定义spring执行顺序
动画绘制API（负责动画执行）
动画：是实现react spring动画效果的基础。通过上述API生成的所有弹簧必须通过动画标记才能绘制动画（动画的执行器）
插值：将spring中执行过程的转换属性值与动画XXX绑定（添加到属性，如style\classname）、数据映射或属性值修改（绑定动画和执行器）进行比较
默认配置
配置：弹簧属性的默认值（影响动画的速度、加速度、延迟和错误等基本属性）（官方示例）
to 属性可以是异步函数(过渡效果从上到下依次实现)
{
to: async (next: any, cancel: any) => {
await next({ opacity: 1, color: '#ffaaee', fontSize: 30 });
await next({ opacity: 0.5, color: 'rgb(14,26,19)', fontSize: 20 });
},
}
to 属性可以是数组(过渡效果从左到右依次实现)
{ to: [{opacity: 1, color: '#ffaaee'}, {opacity: 0, color: 'rgb(14,26,19)'}], }to属性的值可以与其他属性平级(props的其他属性)
{
from: { o: 0.3, xyz: [0, 0, 0], color: 'red' },
o: 1,
xyz: [10, 20, 5],
color: 'green',
reverse: visible,
}useSpring
Usespring用于创建单独的动画，这是API其余部分的基础。它接收包含动画属性的对象或返回值为对象作为参数的箭头函数
参数为object
接收usespringprops类型的对象
返回animatedvalue类型的对象
可以通过外部usestate控制动画属性的更改。通过ref修改状态并调整重置和其他属性将执行相应的动画
config.default { mass: 1, tension: 170, friction: 26 }
config.gentle { mass: 1, tension: 120, friction: 14 }
config.wobbly { mass: 1, tension: 180, friction: 12 }
config.stiff { mass: 1, tension: 210, friction: 20 }
config.slow { mass: 1, tension: 280, friction: 60 }
config.molasses { mass: 1, tension: 280, friction: 120 }参数是一个箭头函数，返回对象
arrow函数返回usespringprops类型的对象
返回[animationvalue，set，stop]的数组
动画属性的更改只能通过set函数重新传递。可以使用“停止”方法提前结束动画
返回值为对象时 useSpring
返回值为数组 useSprings useTrail
xxx 为from和to属性中返回的属性
interface AnimatedValue {
[key in (form & to)]: AnimatedInterpolation;
}
type AnimatedValues = Array<AnimatedValue>;animated 组件
在react弹簧挂钩中使用动画相对简单。您可以直接使用animated XXX导出要从animated中使用的HTML标记，然后将spring直接分配给属性，例如style
无需附加任何属性，直接使用传入from和to的值作为style的属性。
springs当生成spring动画数组时，通过map解构获取单个spring，然后将值添加给animated。
通过interpolate获取传入的参数，返回新的style属性
const spring = useSpring({...})
<animated.div style={spring}></animated.div>
<animated.div style={{transfrom: spring.xxx.interpolate(x=>`translate2d(${x}px, 0)`)}}></animated.div>
const springs = useSpring(5, [{...}])
//
springs.map((spring, index) => (<animated.div key={index} style={{...spring}} />))}
springs.map((spring, index) => (<animated.div key={index} style={{transfrom: spring.xxx.interpolate(x=>`translate2d(${x}px, 0)`)}} />))}UseTransitionProps 生命周期动画属性与返回值
from的功能与initial的功能相同，initial是enter的起始值。但是，“初始”仅在首次加载组件时有效，而“自”在每次装入组件时有效。初始优先级较高
interface UseTransitionProps {
// 动画弹簧基本属性
config?: SpringConfig | ((item: TItem) => SpringConfig)
// 如果为true，key值相同的Spring将被重用
unique?: boolean default false
// 动画开始前的延迟（毫秒），每次进入/更新和离开时加起来
trail?: number
// 动画开始的起始属性(每次mounted是enter的起始值)
from?: InferFrom<DS> | ((item: TItem) => InferFrom<DS>)
// 组件mounted的动画属性
enter?: InferFrom<DS> | InferFrom<DS>[] | ((item: TItem) => InferFrom<DS>)
// 组件unmounted的动画属性
leave?: InferFrom<DS> | InferFrom<DS>[] | ((item: TItem) => InferFrom<DS>)
// 组件的属性更新时的动画属性(Item的值变化时，在enter之后启动，可以通过hook控制state变化)
update?: InferFrom<DS> | InferFrom<DS>[] | ((item: TItem) => InferFrom<DS>)
// 动画初始值，第一次加载的值(只有第一次mounted有效)
initial?: InferFrom<DS> | ((item: TItem) => InferFrom<DS>) | null
// 在组件销毁时调用
onDestroyed?: (isDestroyed: boolean) => void
}
interface UseTransitionResult {
// items的单个项，如果items是boolean则为boolean的值
item: TItem
// key值，如果不设置为null，则默认key=>key自动生成
key: string
// 当前值状态 inital、enter、leave、update
state: State
// 动画属性
props: AnimatedValue
}
