正文
本篇文章是此专栏的第二篇文章,上一篇文章简单写了下 Compose
的动画,让大家先看了下 Compose
开箱即用的动画效果,效果还是挺好的,感兴趣的可以去看下:Compose 动画艺术探索之瞅下 Compose 的动画
从可见性动画看起
可见性动画在上一篇文章中介绍过,不过只是简单使用,没看过上一篇文章的也不用担心,给大家看下可见性动画的实际效果。
实现代码也很简单,来回顾下:
val visible = remember { mutableStateOf(true) }
AnimatedVisibility(visible = visible.value,) {
Text(text = "天青色等烟雨,而我在等你,炊烟袅袅升起,隔江千万里")
}
上一篇文章主要介绍了 Compose
动画的便携之处,例如上面代码,确实非常简单就能实现之前原生安卓中比较难实现的动画效果,今天咱们就来稍微深入一点看看,从小节标题也能知道,就从可见性动画来看!
怎么看呢?直接点进去源码来看!先来看看 AnimatedVisibility
的函数定义吧!
@Composable
fun AnimatedVisibility(
visible: Boolean,
modifier: Modifier = Modifier,
enter: EnterTransition = fadeIn() + expandIn(),
exit: ExitTransition = shrinkOut() + fadeOut(),
label: String = "AnimatedVisibility",
content: @Composable() AnimatedVisibilityScope.() -> Unit
) {
val transition = updateTransition(visible, label)
AnimatedEnterExitImpl(transition, { it }, modifier, enter, exit, content)
}
其实可组合项 AnimatedVisibility
不是只有这一个,目前 Compose 1.3.0-beta02
版本中有六个,这个咱们待会再说,先看这一个,也是第一个,可以看到函数中一共可以接收六个参数,下面先来看看这六个参数分别有什么作用吧:
- visible:定义内容是否应该可见,true 为可见,false 为不可见
- modifier:修饰符,这个就不多说了,在
Compose
中Modifier
简直随处可见 - enter:内容出现时的动画,可以看到这个参数有默认值,默认值为
fadeIn() + expandIn()
,大致意思为淡入并扩展开 - exit:内容由可见变为不可见时的动画,同样的,这个参数也有默认值,默认值为
shrinkOut() + fadeOut()
,大致意思为缩小并淡出消失 - label:字面意思理解为标签,默认值为
AnimatedVisibility
,可以自定义做标记,用于区分不同动画 - content:需要添加可见性动画的可组合项。
上面这些参数除了 enter
和 exit
外都比较好理解,这里就不做过多解释,重点来看下 enter
和 exit
,可以看到 enter
的类型为 EnterTransition
,exit
的类型为 ExitTransition
,那么接下来咱们来分别看看 EnterTransition
和 ExitTransition
吧!
这里其实有一个小问题,可以看到上面 Gif 图中并不是淡入并扩展和缩小并消失,这是为什么呢?继续往下看就能找到答案!
进入过渡——EnterTransition
顾名思义,这个类主要是为了做进入过渡的,来简单看下它的源码吧:
@Immutable
sealed class EnterTransition {
internal abstract val data: TransitionData
// 组合不同的进入转换。组合的顺序并不重要,因为这些将同时启动
@Stable
operator fun plus(enter: EnterTransition): EnterTransition {
return EnterTransitionImpl(
TransitionData(
fade = data.fade ?: enter.data.fade,
slide = data.slide ?: enter.data.slide,
changeSize = data.changeSize ?: enter.data.changeSize,
scale = data.scale ?: enter.data.scale
)
)
}
companion object {
// 当不需要输入转换时,可以使用此函数。
val None: EnterTransition = EnterTransitionImpl(TransitionData())
}
}
可以看到 EnterTransition
是一个密封类, 类中有一个抽象的不可变值 data
,类型为 TransitionData
,这个放到下面来说;类中还有一个函数,而且该函数有 operator
前缀, 这表示运算符重载,重载了“+”号,所以就可以使用“+”来组合不同的输入动画了,函数接收的参数也是 EnterTransition
,然后直接返回 EnterTransitionImpl
,又没见过,怎么办?继续看看 EnterTransitionImpl
是个啥!
@Immutable
private class EnterTransitionImpl(override val data: TransitionData) : EnterTransition()
可以看到 EnterTransitionImpl
类很简单,是一个私有类,继承自 EnterTransition
,注意类上有 Immutable
注解, Immutable
注解可用于将类标记为生成不可变实例,但类的不变性没有得到验证,它是类型的一种承诺,即在构造实例之后,所有公开可访问的属性和字段都不会更改。 EnterTransitionImpl
还需要实现父类的抽象值,所有有 TransitionData
类型的参数 data
,上面咱们简单提到了 TransitionData
,这里来看下吧!
@Immutable
internal data class TransitionData(
val fade: Fade? = null,
val slide: Slide? = null,
val changeSize: ChangeSize? = null,
val scale: Scale? = null
)
可以看到 TransitionData
类也有 Immutable
注解,这里就不做过多介绍,这是一个包内可见的数据类,里面有四个不可变值,分别是 Fade
、Slide
、ChangeSize
、Scale
,其实从名称就能看出这几个参数分别代表的意思,不过还是来看下它们的源码吧!
@Immutable
internal data class Fade(val alpha: Float, val animationSpec: FiniteAnimationSpec<Float>)
@Immutable
internal data class Slide(
val slideOffset: (fullSize: IntSize) -> IntOffset,
val animationSpec: FiniteAnimationSpec<IntOffset>
)
@Immutable
internal data class ChangeSize(
val alignment: Alignment,
val size: (fullSize: IntSize) -> IntSize = { IntSize(0, 0) },
val animationSpec: FiniteAnimationSpec<IntSize>,
val clip: Boolean = true
)
@Immutable
internal data class Scale(
val scale: Float,
val transformOrigin: TransformOrigin,
val animationSpec: FiniteAnimationSpec<Float>
)
可以看到这四个类都是不可变的数据类,分别表示颜色转变、滑动、大小变化及缩放。这几个类有一个共同点,都有一个共同的参数 animationSpec
,参数类型为 FiniteAnimationSpec
,来看看 FiniteAnimationSpec
是个啥?
interface FiniteAnimationSpec<T> : AnimationSpec<T> {
override fun <V : AnimationVector> vectorize(
converter: TwoWayConverter<T, V>
): VectorizedFiniteAnimationSpec<V>
}
可以看到 FiniteAnimationSpec
是一个接口,继承自 AnimationSpec
,简单理解就是有限动画规格,定义了动画的时长及动画效果等,类似于原生安卓中的什么呢?嗯。。。差值器吧!FiniteAnimationSpec
是所有非无限动画实现的接口,包括: TweenSpec
, SpringSpec
, KeyframesSpec
, RepeatableSpec
, SnapSpec
等等,上一篇文章中说到的无限循环动画 InfiniteRepeatableSpec
没有继承这个接口,其实从名字看就知道了,InfiniteRepeatableSpec
也继承自 AnimationSpec
。。。。
不行不行,扯太远了,其实看源码就是这样,看着看着一直往下看就会迷失了最初的目标,越看越多,越看越多,这里就先不接着往下看了,再看就没完没了了,这里咱们知道这四个类大概存储了什么数据就行了。动画规格咱们放到之后的文章中慢慢看,今天主要来过一遍可见性动画!
简单总结下, EnterTransition
类中有一个函数,进行了运算符重载,可以有多个动画同时进行。
关闭过渡——ExitTransition
其实看完刚才的 EnterTransition
类再来看 ExitTransition
就会觉得很简单了,不信的话咱们来看下 ExitTransition
的源码:
@Immutable
sealed class ExitTransition {
internal abstract val data: TransitionData
// 结合不同的退出转换,组合顺序并不重要
@Stable
operator fun plus(exit: ExitTransition): ExitTransition {
return ExitTransitionImpl(
TransitionData(
fade = data.fade ?: exit.data.fade,
slide = data.slide ?: exit.data.slide,
changeSize = data.changeSize ?: exit.data.changeSize,
scale = data.scale ?: exit.data.scale
)
)
}
companion object {
// 当不需要内置动画时使用
val None: ExitTransition = ExitTransitionImpl(TransitionData())
}
}
是不是基本一致,连抽象不可变值都一摸一样,甚至值的名称都没变!唯一不同的是 EnterTransition
的实现类为 EnterTransitionImpl
,而 ExitTransition
的子类为 ExitTransitionImpl
,那就再看看 ExitTransitionImpl
!
@Immutable
private class ExitTransitionImpl(override val data: TransitionData) : ExitTransition()
和 EnterTransitionImpl
不能说相似,只能说一摸一样。。。所以就不做过多介绍。。。
过渡——Transition
文章开头的时候看 AnimatedVisibility
函数中只有下面的两行代码,
val transition = updateTransition(visible, label)
AnimatedEnterExitImpl(transition, { it }, modifier, enter, exit, content)
这一小节咱们先来看第一行,可以看到调用了 updateTransition
函数, 传入了当前显示状态和标签,来具体看下这个函数吧!
@Composable
fun <T> updateTransition(
targetState: T,
label: String? = null
): Transition<T> {
val transition = remember { Transition(targetState, label = label) }
transition.animateTo(targetState)
DisposableEffect(transition) {
onDispose {
// 出去的时候清理干净,确保观察者不会被困在中间状态
transition.onTransitionEnd()
}
}
return transition
}
可以看到这个函数也是一个可组合项,返回值为 Transition
,函数中先记住并构建了一个 Transition
,然后调用了 Transition
的 animateTo
函数来执行过渡动画,然后调用了需要清理的效应 DisposableEffect
,之后在 onDispose
中调用了 onTransitionEnd
函数,以防卡在这里,最后返回刚才构建的 Transition
。
函数中的内容不难理解,现在唯一困惑的是 Transition
是个什么东西!那就来看看!
@Stable
class Transition<S> @PublishedApi internal constructor(
private val transitionState: MutableTransitionState<S>,
val label: String? = null
)
这就是 Transition
的类声明,Transition
在状态级别上管理所有子动画。子动画可以使用Transition
以声明的方式创建。animateFloat
、animateValue
、animateColor
animateColor
等。当 targetState
改变时,Transition
将自动启动或调整其所有子动画的路线,使其动画到为每个动画定义的新目标值。
可以看到 Transition
构造函数中接收一个 MutableTransitionState
类型的参数和一个 lable
,但咱们看到上面传入的并不是 MutableTransitionState
类型的参数,肯定还有别的构造函数!
internal constructor(
initialState: S,
label: String?
) : this(MutableTransitionState(initialState), label)
没错,确实还有一个构造函数,接下来看下 MutableTransitionState
吧!
class MutableTransitionState<S>(initialState: S) {
// 当前的状态
var currentState: S by mutableStateOf(initialState)
internal set
// 过渡的目标状态
var targetState: S by mutableStateOf(initialState)
// 是否空闲
val isIdle: Boolean
get() = (currentState == targetState) && !isRunning
// 是否运行
internal var isRunning: Boolean by mutableStateOf(false)
}
可以看到 MutableTransitionState
中构建了几个需要的状态,具体表示什么在上面代码中添加了注释。
过渡动画实现——AnimatedEnterExitImpl
刚才看了 AnimatedVisibility
函数中的第一行代码,下面咱们来看下第二行代码:
AnimatedEnterExitImpl(transition, { it }, modifier, enter, exit, content)
这块调用了一个实现函数,将刚构建好的 Transition
和之前的 EnterTransition
、ExitTransition
统统传了进去,下面就来看下 AnimatedEnterExitImpl
!
@Composable
private fun <T> AnimatedEnterExitImpl(
transition: Transition<T>,visible: (T) -> Boolean,
modifier: Modifier,enter: EnterTransition,
exit: ExitTransition,content: @Composable() AnimatedVisibilityScope.() -> Unit
) {
val isAnimationVisible = remember(transition) {
mutableStateOf(visible(transition.currentState))
}
if (visible(transition.targetState) || isAnimationVisible.value || transition.isSeeking) {
val childTransition = transition.createChildTransition(label = "EnterExitTransition") {
transition.targetEnterExit(visible, it)
}
LaunchedEffect(childTransition) {
snapshotFlow {
childTransition.currentState == EnterExitState.Visible ||
childTransition.targetState == EnterExitState.Visible
}.collect {
isAnimationVisible.value = it
}
}
AnimatedEnterExitImpl(childTransition,modifier,
enter = enter,exit = exit,content = content
)
}
}
这块代码有点多啊,但不要害怕,可以看到基本上这里使用到的类在刚才咱们都看过了,接下来需要的就是一行一行往下看,看看哪个没见过咱们再看!
函数中先记录了当前的状态,然后判断当前的状态值是否为 true,如果为 true 的话则创建子过渡,老规矩,来看看 createChildTransition
!
@Composable
inline fun <S, T> Transition<S>.createChildTransition(
label: String = "ChildTransition",
transformToChildState: @Composable (parentState: S) -> T,
): Transition<T> {
val initialParentState = remember(this) { this.currentState }
val initialState = transformToChildState(if (isSeeking) currentState else initialParentState)
val targetState = transformToChildState(this.targetState)
return createChildTransitionInternal(initialState, targetState, label)
}
可以看到 createChildTransition
是 Transition
的一个扩展函数,还是一个高阶函数,函数内获取了高阶函数中的返回值,然后直接返回调用了 createChildTransitionInternal
,并传入获取的值,这个值目前还不知道是什么,只知道是 targetEnterExit
返回的数据,这个一会再看,先接着看 createChildTransitionInternal
函数:
@Composable
internal fun <S, T> Transition<S>.createChildTransitionInternal(
initialState: T,
targetState: T,
childLabel: String,
): Transition<T> {
val transition = remember(this) {
Transition(MutableTransitionState(initialState), "${this.label} > $childLabel")
}
DisposableEffect(transition) {
addTransition(transition)
onDispose {
removeTransition(transition)
}
}
if (isSeeking) {
transition.setPlaytimeAfterInitialAndTargetStateEstablished(
initialState,
targetState,
this.lastSeekedTimeNanos
)
} else {
transition.updateTarget(targetState)
transition.isSeeking = false
}
return transition
}
可以看到 createChildTransitionInternal
也是 Transition
的一个扩展函数,然后函数中也使用了需要清理的效应,之后判断 isSeeking
的值是,isSeeking
的值在 setPlaytimeAfterInitialAndTargetStateEstablished
函数中会被置为 true,如果 isSeeking
值为 true 则调用 setPlaytimeAfterInitialAndTargetStateEstablished
函数,用来设置初始状态和目标状态建立后的时间,如果为 false,则更新状态值。
到这里 createChildTransition
函数咱们大概看了下,但刚才还有一个扣,刚才说了不知道目标值是什么,因为那是 targetEnterExit
的返回值,现在咱们来看看!
@Composable
private fun <T> Transition<T>.targetEnterExit(
visible: (T) -> Boolean,
targetState: T
): EnterExitState = key(this) {
if (this.isSeeking) {
if (visible(targetState)) {
Visible
} else {
if (visible(this.currentState)) {
PostExit
} else {
PreEnter
}
}
} else {
val hasBeenVisible = remember { mutableStateOf(false) }
if (visible(currentState)) {
hasBeenVisible.value = true
}
if (visible(targetState)) {
EnterExitState.Visible
} else {
// If never been visible, visible = false means PreEnter, otherwise PostExit
if (hasBeenVisible.value) {
EnterExitState.PostExit
} else {
EnterExitState.PreEnter
}
}
}
}
同样的,targetEnterExit
也是一个扩展函数,返回值为 EnterExitState
。这里也使用了 isSeeking
来进行判断,然后根据当前的值来设置不同的 EnterExitState
。EnterExitState
又是个啥呢???接着来看!
enum class EnterExitState {
// 自定义进入动画的初始状态。
PreEnter,
// 自定义进入动画的目标状态,也是动画过程中自定义退出动画的初始状态。
Visible,
// 自定义退出动画的目标状态。
PostExit
}
奥,EnterExitState
只是一个枚举类,定义了三种状态:初始状态、进入动画的状态和退出动画的状态。
下面接着来看 AnimatedEnterExitImpl
:
LaunchedEffect(childTransition) {
snapshotFlow {
childTransition.currentState == EnterExitState.Visible ||
childTransition.targetState == EnterExitState.Visible
}.collect {
isAnimationVisible.value = it
}
}
AnimatedEnterExitImpl(childTransition,modifier,
enter = enter,exit = exit,content = content
)
这里使用了 LaunchedEffect
效应,并使用 snapshotFlow
将 State
转为了 Flow
,然后将值设置到 isAnimationVisible
。
后面又调用了相同名字的一个函数 AnimatedEnterExitImpl
:
@Composable
private inline fun AnimatedEnterExitImpl(
transition: Transition<EnterExitState>,
modifier: Modifier,
enter: EnterTransition,
exit: ExitTransition,
content: @Composable AnimatedVisibilityScope.() -> Unit
) {
if (transition.currentState == EnterExitState.Visible ||
transition.targetState == EnterExitState.Visible
) {
val scope = remember(transition) { AnimatedVisibilityScopeImpl(transition) }
Layout(
content = { scope.content() },
modifier = modifier.then(transition.createModifier(enter, exit, "Built-in")),
measurePolicy = remember { AnimatedEnterExitMeasurePolicy(scope) }
)
}
}
函数名字一样,但参数不同,这里将刚才构建好的 Transition<EnterExitState>
传了进来,然后函数内先对状态进行了过滤,然后构建了 Layout
。
Layout
中设置了 modifier
,modifier
调用了 then
函数,then
函数用于将此修饰符与另一个修饰符连接,然后连接了 transition.createModifier(enter, exit, "Built-in")
,大家发现点什么没有,这里使用到了上面咱们构建好了所有东西。。。那么。。。。哈哈哈哈!
柳暗花明
下面咱们就来看看 transition.createModifier
这个函数,先来看下函数体:
@Composable
internal fun Transition<EnterExitState>.createModifier(
enter: EnterTransition,
exit: ExitTransition,
label: String
): Modifier
嗯,没错,是 Transition<EnterExitState>
的一个扩展函数,也是一个可组合项!接着往下看几行代码:
var modifier: Modifier = Modifier
modifier = modifier.slideInOut(
this,
rememberUpdatedState(enter.data.slide),
rememberUpdatedState(exit.data.slide),
label
).shrinkExpand(
this,
rememberUpdatedState(enter.data.changeSize),
rememberUpdatedState(exit.data.changeSize),
label
)
构建了一个 Modifier
,然后调用了 slideInOut
和 shrinkExpand
,没错,这是滑动和缩小放大!接着来!
var shouldAnimateAlpha by remember(this) { mutableStateOf(false) }
var shouldAnimateScale by remember(this) { mutableStateOf(false) }
if (currentState == targetState && !isSeeking) {
shouldAnimateAlpha = false
shouldAnimateScale = false
} else {
if (enter.data.fade != null || exit.data.fade != null) {
shouldAnimateAlpha = true
}
if (enter.data.scale != null || exit.data.scale != null) {
shouldAnimateScale = true
}
}
创建两个值来记录是否需要透明度的转换和缩放!下面来看下执行的代码:
if (shouldAnimateScale) {
......
modifier = modifier.graphicsLayer {
this.alpha = alpha
this.scaleX = scale
this.scaleY = scale
this.transformOrigin = transformOrigin
}
} else if (shouldAnimateAlpha) {
modifier = modifier.graphicsLayer {
this.alpha = alpha
}
}
嗯呢,是不是豁然开朗!但是 slideInOut
和 shrinkExpand
函数也是可见性动画这里定义的 Modifier
的扩展函数,里面还有一些自定义的东西,但这不是本文的重点了。
别的可见性动画
文章开头说了,可见性动画目前一共有六个,听着很吓人,其实大同小异,来简单看下不同吧!
@Composable
fun RowScope.AnimatedVisibility(
visible: Boolean,
modifier: Modifier = Modifier,
enter: EnterTransition = fadeIn() + expandHorizontally(),
exit: ExitTransition = fadeOut() + shrinkHorizontally(),
label: String = "AnimatedVisibility",
content: @Composable() AnimatedVisibilityScope.() -> Unit
) {
val transition = updateTransition(visible, label)
AnimatedEnterExitImpl(transition, { it }, modifier, enter, exit, content)
}
@Composable
fun ColumnScope.AnimatedVisibility(
visible: Boolean,
modifier: Modifier = Modifier,
enter: EnterTransition = fadeIn() + expandVertically(),
exit: ExitTransition = fadeOut() + shrinkVertically(),
label: String = "AnimatedVisibility",
content: @Composable AnimatedVisibilityScope.() -> Unit
) {
val transition = updateTransition(visible, label)
AnimatedEnterExitImpl(transition, { it }, modifier, enter, exit, content)
}
上面这两个和咱们上面说的基本一样,只不过一个是 RowScope
的扩展函数,另一个是 ColumnScope
的扩展函数,并且在默认动画上还有些区别,RowScope
默认是横向的扩展和收缩,ColumnScope
是纵向的扩展和收缩,更加方便咱们日常调用!这也就解释了文章开头提出的小问题!
接着再来看别的!
@Composable
fun AnimatedVisibility(
visibleState: MutableTransitionState<Boolean>,
modifier: Modifier = Modifier,
enter: EnterTransition = fadeIn() + expandIn(),
exit: ExitTransition = fadeOut() + shrinkOut(),
label: String = "AnimatedVisibility",
content: @Composable() AnimatedVisibilityScope.() -> Unit
) {
val transition = updateTransition(visibleState, label)
AnimatedEnterExitImpl(transition, { it }, modifier, enter, exit, content)
}
这个和之前的就有点区别了,第一个参数就不同了,参数类型为 MutableTransitionState
,其实是一样的,咱们上面也都说到了,MutableTransitionState
的使用方法在上一篇文章中也介绍过,感兴趣的可以去看一下。
剩下的两个还是 RowScope
和 ColumnScope
的扩展函数,也是参数类型改为了 MutableTransitionState
,这里也就不做过多介绍。
结尾
本篇文章带大家看了可见性动画的一些源码,很多其实都是点到为止,并没有一致不断深入,一直深入就会陷入其中,忘了看源码的本意,本文所有源码基于 Compose 1.3.0-beta02
。
本文至此结束,有用的地方大家可以参考,当然如果能帮助到大家,更多关于Compose 可见性动画的资料请关注编程网其它相关文章!