Android过渡动画Scene and Transition（三）：Transition的辅助工具

Transition框架除了核心的Scene、Transition和TransitionManager类，还提供了强大的辅助工具类和方法帮助我们实现更为灵活的过渡动画。

一、Transition的作用域

通常情况下，我们只需要对一个view hierarchy中的部分view执行动画，比如将一个RecyclerView作为整体执行动画，此时我我们需要忽略其子view。或者当自定义Transition只对特定类型view有用时，我们会在自定义Transition时忽略其他类型view。Transition框架为我们提供了丰富的API处理类似问题。

1、addTarget()方法指定过渡动画的目标View

通过addTarget()方法指定Transition的目标view群体，该transition只对满足条件的view起作用

//通过view的id属性指定target view
fun addTarget(targetId: Int): Transition
//通过view的mTransitionName属性指定target view
fun addTarget(targetName: String?): Transition
//通过直接指定view对象引用指定target view
fun addTarget(target: View?): Transition
//通过view的类型指定target view
@RequiresApi(Build.VERSION_CODES.LOLLIPOP)
fun addTarget(targetType: Class<*>?): Transition

2、excludeTarget()方法过滤Transitioin的目标View

excludeTarget()方法与addTarget()方法相反，通过此方法过滤Transition的目标view群体，该transition对满足条件的view不起作用。

//通过view的id属性过滤target view
fun excludeTarget(targetId: Int, exclude: Boolean): Transition
//通过view的mTransitionName属性过滤target view
fun excludeTarget(targetName: String?, exclude: Boolean): Transition 
//通过直接指定view对象引用过滤target view
fun excludeTarget(target: View?, exclude: Boolean): Transition
//通过view的类型过滤target view
fun excludeTarget(type: Class<*>?, exclude: Boolean): Transition

3、excludeChildren()方法设置是否过滤指定ViewGroup的子View

excludeChildren()方法根据传入的exclude参数决定是否过滤指定ViewGroup的子View

//过滤指定id的viewgroup的子view
fun excludeChildren(targetId: Int, exclude: Boolean): Transition
//过滤指定对象引用的viewgroup的子view
fun excludeChildren(target: View?, exclude: Boolean): Transition
//过滤指定类型的viewgroup的子view
fun excludeChildren(type: Class<*>?, exclude: Boolean): Transition

二、TransitionPropagation自定义Transition的startDelay

有时候，我们期望一个Transition对不同的view执行动画时，具有不同的startDelay，而不是TransitionSet的顺序执行。一个典型的场景是RecyclerView添加Item集合时能够根据item的position计算不同item的入场顺序（即startDelay），通过自定义并使用TransitionPropagation能够轻松实现item动画千变万化的入场顺序。

1、自定义TransitionPropagation

TransitionPropagation是一个抽象类，该类只有三个抽象方法。

class CustomTransitionPropagation : TransitionPropagation() {
    override fun captureValues(transitionValues: TransitionValues?) {
    }
    override fun getStartDelay(sceneRoot: ViewGroup?, transition: Transition?, 
    startValues: TransitionValues?, endValues: TransitionValues?): Long {
        return 0
    }
    override fun getPropagationProperties(): Array<String>? {
        return null
    }
}

其中getStartDelay()方法返回的便是此方法传入的transition对startValues或endValues对应的view执行该transition的startDelay。一些情况下，我们只需要实现此方法即可。但是，很多时候，我们仅仅依靠Transition原有的TransitionValues无法实现我们需要的效果，此时就需要另外两个方法来让Transition抓取、保存我们需要关注的额外数据，然后根据保存的数据和我们定制的规则来计算startDelay。

例如，在上面提到的RecyclerView添加item时，items需要根据position计算每个item的入场顺序。此例中，item的position属性是Transition的TransitionValues所没有的，我们便可以通过这两个方法将position捕获，保存到TransitionValues中。因此，此类中三个方法的调用顺序为：

getPropagationProperties()：声明额外关注的属性，transition计算startValue和endValue时调用；
captureValues()：捕获并保存额外关注的属性，transition计算startValue和endValue时调用；
getStartDelay()：根据规则计算startDelay，创建Animators时调用并设置。

2、使用TransitionPropagation

通过Transition的实例方法setPropagation()使用。

3、内建的TransitionPropagation

CircularPropagation，指定震源，并以震源开始向外地震波式的动画执行顺序（startDelay）；
SidePropagation，根据与震源相对距离实现波浪式动画执行顺序。

4、计算震源的回调

class CustomEpicenterCallback : Transition.EpicenterCallback() {
    override fun onGetEpicenter(transition: Transition): Rect? {
        return null
    }
}

5、示例代码

package com.iyao.transition
import android.support.transition.Transition
import android.support.transition.TransitionPropagation
import android.support.transition.TransitionValues
import android.support.v7.widget.RecyclerView
import android.view.View
import android.view.ViewGroup
class PositionPropagation(private var recyclerView: RecyclerView?) : TransitionPropagation() {
    companion object {
        private const val PROPERTY_NAME_POSITION = "android:PositionPropagation:position"
        private const val STEP_OF_DELAY = 100L
        private val PROPERTY_NAMES = arrayOf(PROPERTY_NAME_POSITION)
    }
    init {
        recyclerView?.addOnAttachStateChangeListener(object : View.OnAttachStateChangeListener {
            override fun onViewDetachedFromWindow(v: View?) {
                recyclerView?.removeOnAttachStateChangeListener(this)
                recyclerView = null
            }
            override fun onViewAttachedToWindow(v: View?) {
            }
        })
    }
    override fun captureValues(transitionValues: TransitionValues?) {
        val view = transitionValues?.view
        if (recyclerView != null && view?.parent == recyclerView) {
            val position = recyclerView?.getChildLayoutPosition(view) ?: -1
            if (position >= 0 && position < recyclerView?.adapter?.itemCount ?: 0) {
                transitionValues?.values?.put(PROPERTY_NAME_POSITION, position)
            }
        }
    }
    override fun getStartDelay(sceneRoot: ViewGroup?, transition: Transition?, startValues: TransitionValues?, endValues: TransitionValues?): Long {
        val position = endValues?.values?.get(PROPERTY_NAME_POSITION) as Int
        return position * STEP_OF_DELAY
    }
    override fun getPropagationProperties(): Array<String>? {
        return PROPERTY_NAMES
    }
}

注：示例代码仅作流程参考，并未真正运行过，很可能存在Bug。

PathMotion计算Transition作用的View的运动轨迹

1、自定义PathMotion

类似ChangeBounds这种移动View实现的Transition，Transition框架提供了一种路径相关的interpolator叫做PathMotion。两点之间的运动轨迹有无数可能，这个类便是用于实现这无数种可能的。这个类很简单，两个构造器，一个无参的用于code方式创建，一个有参数用于XML方式创建。唯一的方法getPath()提供Transition作用的View的起点坐标与终点坐标，根据这两个坐标计算Path并返回。

class CustomPathMotion : PathMotion() {
    override fun getPath(startX: Float, startY: Float, endX: Float, endY: Float): Path? {
        return null
    }
}

2、使用PathMotion

通过Transition的实例方法setPathMotion()使用。

3、内建的PathMotion

ArcMotion，三阶贝塞尔曲线路径；
PatternPathMotion，矢量路径。

上一篇：Android过渡动画Scene and Transition（二）：自定义Transition