public class Fade extends Visibility
View.setVisibility(int)
state of the view as well as whether it
is parented in the current view hierarchy.
The ability of this transition to fade out a particular view, and the
way that that fading operation takes place, is based on
the situation of the view in the view hierarchy. For example, if a view was
simply removed from its parent, then the view will be added into a ViewGroupOverlay
while fading. If a visible view is
changed to be View.GONE
or View.INVISIBLE
, then the
visibility will be changed to View.VISIBLE
for the duration of
the animation. However, if a view is in a hierarchy which is also altering
its visibility, the situation can be more complicated. In general, if a
view that is no longer in the hierarchy in the end scene still has a
parent (so its parent hierarchy was removed, but it was not removed from
its parent), then it will be left alone to avoid side-effects from
improperly removing it from its parent. The only exception to this is if
the previous Scene
was
created from a layout resource file
, then it is considered safe to un-parent
the starting scene view in order to fade it out.
A Fade transition can be described in a resource file by using the
tag fade
, along with the standard
attributes of android.R.styleable#Fade
and
android.R.styleable#Transition
.
Transition.AnimationInfo, Transition.EpicenterCallback, Transition.TransitionListener, Transition.TransitionListenerAdapter
Modifier and Type | Field and Description |
---|---|
static int |
IN
Fading mode used in
Fade(int) to make the transition
operate on targets that are appearing. |
static int |
OUT
Fading mode used in
Fade(int) to make the transition
operate on targets that are disappearing. |
MODE_IN, MODE_OUT
MATCH_ID, MATCH_INSTANCE, MATCH_ITEM_ID, MATCH_NAME
Constructor and Description |
---|
Fade()
Constructs a Fade transition that will fade targets in and out.
|
Fade(Context context,
AttributeSet attrs) |
Fade(int fadingMode)
Constructs a Fade transition that will fade targets in
and/or out, according to the value of fadingMode.
|
Modifier and Type | Method and Description |
---|---|
void |
captureStartValues(TransitionValues transitionValues)
Captures the values in the start scene for the properties that this
transition monitors.
|
Animator |
onAppear(ViewGroup sceneRoot,
View view,
TransitionValues startValues,
TransitionValues endValues)
The default implementation of this method returns a null Animator.
|
Animator |
onDisappear(ViewGroup sceneRoot,
View view,
TransitionValues startValues,
TransitionValues endValues)
The default implementation of this method returns a null Animator.
|
captureEndValues, createAnimator, getMode, getTransitionProperties, isTransitionRequired, isVisible, onAppear, onDisappear, setMode, setSuppressLayout
addListener, addTarget, addTarget, addTarget, addTarget, animate, cancel, canRemoveViews, clone, createAnimators, end, excludeChildren, excludeChildren, excludeChildren, excludeTarget, excludeTarget, excludeTarget, excludeTarget, getDuration, getEpicenter, getEpicenterCallback, getInterpolator, getName, getNameOverrides, getPathMotion, getPropagation, getStartDelay, getTargetIds, getTargetNames, getTargets, getTargetTypes, getTargetViewNames, getTransitionValues, pause, removeListener, removeTarget, removeTarget, removeTarget, removeTarget, resume, runAnimators, setDuration, setEpicenterCallback, setInterpolator, setMatchOrder, setNameOverrides, setPathMotion, setPropagation, setStartDelay, start, toString
public static final int IN
Fade(int)
to make the transition
operate on targets that are appearing. Maybe be combined with
OUT
to fade both in and out. Equivalent to
Visibility.MODE_IN
.public static final int OUT
Fade(int)
to make the transition
operate on targets that are disappearing. Maybe be combined with
IN
to fade both in and out. Equivalent to
Visibility.MODE_OUT
.public Fade()
public Fade(int fadingMode)
public Fade(Context context, AttributeSet attrs)
public void captureStartValues(TransitionValues transitionValues)
Transition
Transition.createAnimator(ViewGroup, TransitionValues, TransitionValues)
.
The main concern for an implementation is what the
properties are that the transition cares about and what the values are
for all of those properties. The start and end values will be compared
later during the
Transition.createAnimator(android.view.ViewGroup, TransitionValues, TransitionValues)
method to determine what, if any, animations, should be run.
Subclasses must implement this method. The method should only be called by the transition system; it is not intended to be called from external classes.
captureStartValues
in class Visibility
transitionValues
- The holder for any values that the Transition
wishes to store. Values are stored in the values
field
of this TransitionValues object and are keyed from
a String value. For example, to store a view's rotation value,
a transition might call
transitionValues.values.put("appname:transitionname:rotation",
view.getRotation())
. The target view will already be stored in
the transitionValues structure when this method is called.Transition.captureEndValues(TransitionValues)
,
Transition.createAnimator(ViewGroup, TransitionValues, TransitionValues)
public Animator onAppear(ViewGroup sceneRoot, View view, TransitionValues startValues, TransitionValues endValues)
Visibility
Visibility.onAppear(ViewGroup, TransitionValues, int, TransitionValues, int)
.onAppear
in class Visibility
sceneRoot
- The root of the transition hierarchyview
- The View to make appear. This will be in the target scene's View hierarchy and
will be VISIBLE.startValues
- The target values in the start sceneendValues
- The target values in the end scenepublic Animator onDisappear(ViewGroup sceneRoot, View view, TransitionValues startValues, TransitionValues endValues)
Visibility
Visibility.onDisappear(ViewGroup, TransitionValues, int, TransitionValues, int)
.onDisappear
in class Visibility
sceneRoot
- The root of the transition hierarchyview
- The View to make disappear. This will be in the target scene's View
hierarchy or in an ViewGroupOverlay
and will be
VISIBLE.startValues
- The target values in the start sceneendValues
- The target values in the end scene