React Spring实战之API以及animated 组件的运用

React Spring实战之API以及animated 组件的运用

2024-04-20
109 浏览
江河入海,知识涌动,这是我参与江海计划的第7篇。
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 属性可以是数组(过渡效果从左到右依次实现)
to属性的值可以与其他属性平级(props的其他属性)
useSpring
Usespring用于创建单独的动画,这是API其余部分的基础。它接收包含动画属性的对象或返回值为对象作为参数的箭头函数 参数为object 接收usespringprops类型的对象 返回animatedvalue类型的对象 可以通过外部usestate控制动画属性的更改。通过ref修改状态并调整重置和其他属性将执行相应的动画
参数是一个箭头函数,返回对象 arrow函数返回usespringprops类型的对象 返回[animationvalue,set,stop]的数组 动画属性的更改只能通过set函数重新传递。可以使用“停止”方法提前结束动画 返回值为对象时 useSpring 返回值为数组 useSprings useTrail xxx 为from和to属性中返回的属性
animated 组件
在react弹簧挂钩中使用动画相对简单。您可以直接使用animated XXX导出要从animated中使用的HTML标记,然后将spring直接分配给属性,例如style 无需附加任何属性,直接使用传入from和to的值作为style的属性。 springs当生成spring动画数组时,通过map解构获取单个spring,然后将值添加给animated。 通过interpolate获取传入的参数,返回新的style属性
 
 
1
2
3
4
5
6
7
8
9
 
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的起始值。但是,“初始”仅在首次加载组件时有效,而“自”在每次装入组件时有效。初始优先级较高
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
 
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
}

posted on 2024-10-20 17:22  漫思  阅读(32)  评论(0编辑  收藏  举报

导航