com.alexvasilkov.gestures.transition

Class ViewsTransitionAnimator<ID>

java.lang.Object

com.alexvasilkov.gestures.transition.ViewsCoordinator<ID>

com.alexvasilkov.gestures.transition.ViewsTransitionAnimator<ID>

public class ViewsTransitionAnimator<ID>
extends ViewsCoordinator<ID>

Extension of ViewsCoordinator that allows requesting enter(Object, boolean) or exit(boolean) animations, keeps track of ViewPositionAnimator.PositionUpdateListener listeners and provides correct implementation of isLeaving().

Usage of this class should be similar to ViewPositionAnimator class.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ViewsTransitionAnimator.RequestListener<ID>

Nested classes/interfaces inherited from class com.alexvasilkov.gestures.transition.ViewsCoordinator

ViewsCoordinator.OnRequestViewListener<ID>, ViewsCoordinator.OnViewsReadyListener<ID>

Constructor Summary

Constructors

Constructor and Description
ViewsTransitionAnimator() Deprecated. Use GestureTransitions instead.

Method Summary

Modifier and Type	Method and Description
void	addPositionUpdateListener(ViewPositionAnimator.PositionUpdateListener listener) Adds position state changes listener that will be notified during animations.
protected void	cleanupRequest()
void	enter(ID id, boolean withAnimation) Requests 'from' and 'to' views for given ID and starts enter animation when views are ready.
void	enterSingle(boolean withAnimation) Similar to enter(ID, boolean) but starts entering from no specific id. Do not use this method if you are actually going to use items ids in FromTracker or IntoTracker.
void	exit(boolean withAnimation) Plays exit animation, should only be called after corresponding call to enter(Object, boolean).
boolean	isLeaving()
protected void	onFromViewChanged(android.view.View fromView, ViewPosition fromPos)
protected void	onToViewChanged(AnimatorView old, AnimatorView view)
protected void	onViewsReady(ID id) Called when both 'from' and 'to' views are ready for given index.
void	removePositionUpdateListener(ViewPositionAnimator.PositionUpdateListener listener) Removes position state changes listener as added by addPositionUpdateListener(...).
void	setFromListener(ViewsCoordinator.OnRequestViewListener<ID> listener)
void	setToListener(ViewsCoordinator.OnRequestViewListener<ID> listener)

Methods inherited from class com.alexvasilkov.gestures.transition.ViewsCoordinator

getFromPos, getFromView, getRequestedId, getToView, isReady, request, setFromNone, setFromPos, setFromView, setReadyListener, setToView

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ViewsTransitionAnimator

@Deprecated
public ViewsTransitionAnimator()

Deprecated. Use GestureTransitions instead.

Method Detail

enter

public void enter(@NonNull
                  ID id,
                  boolean withAnimation)

Requests 'from' and 'to' views for given ID and starts enter animation when views are ready.

Parameters:

id - Item ID for views lookup

withAnimation - Whether to animate entering or immediately jump to entered state

See Also:

ViewsCoordinator

enterSingle

public void enterSingle(boolean withAnimation)

Similar to enter(ID, boolean) but starts entering from no specific id.
Do not use this method if you are actually going to use items ids in FromTracker or IntoTracker.

Can be used if your have single 'from' item with no specific id, like:
GestureTransitions.from(imageView).into(gestureImageView).enterSingle(true)

Parameters:

withAnimation - Whether to animate entering or immediately jump to entered state

exit

public void exit(boolean withAnimation)

Plays exit animation, should only be called after corresponding call to enter(Object, boolean).

Parameters:

withAnimation - Whether to animate exiting or immediately jump to initial state

See Also:

isLeaving()

isLeaving

public boolean isLeaving()

Returns:

Whether 'enter' was not requested recently or animator is in leaving state. Means that animation direction is from final (to) position back to initial (from) position.

addPositionUpdateListener

public void addPositionUpdateListener(@NonNull
                                      ViewPositionAnimator.PositionUpdateListener listener)

Adds position state changes listener that will be notified during animations.

Parameters:

listener - Position listener

See Also:

ViewPositionAnimator.addPositionUpdateListener(PositionUpdateListener)

removePositionUpdateListener

public void removePositionUpdateListener(@NonNull
                                         ViewPositionAnimator.PositionUpdateListener listener)

Removes position state changes listener as added by addPositionUpdateListener(...).

Parameters:

listener - Position listener to be removed

See Also:

ViewPositionAnimator.removePositionUpdateListener(PositionUpdateListener)

setFromListener

public void setFromListener(@NonNull
                            ViewsCoordinator.OnRequestViewListener<ID> listener)

Overrides:

setFromListener in class ViewsCoordinator<ID>

setToListener

public void setToListener(@NonNull
                          ViewsCoordinator.OnRequestViewListener<ID> listener)

Overrides:

setToListener in class ViewsCoordinator<ID>

onFromViewChanged

protected void onFromViewChanged(@Nullable
                                 android.view.View fromView,
                                 @Nullable
                                 ViewPosition fromPos)

Overrides:

onFromViewChanged in class ViewsCoordinator<ID>

onToViewChanged

protected void onToViewChanged(@Nullable
                               AnimatorView old,
                               @NonNull
                               AnimatorView view)

Overrides:

onToViewChanged in class ViewsCoordinator<ID>

onViewsReady

protected void onViewsReady(@NonNull
                            ID id)

Description copied from class: ViewsCoordinator

Called when both 'from' and 'to' views are ready for given index. At this point transition is ready to be started.

Note, that this method will be called each time 'from' or 'to' views are changed.

Overrides:

onViewsReady in class ViewsCoordinator<ID>

Parameters:

id - Item ID used for views lookup

See Also:

ViewsCoordinator.getFromView(), ViewsCoordinator.getFromPos(), ViewsCoordinator.getToView()

cleanupRequest

protected void cleanupRequest()

Overrides:

cleanupRequest in class ViewsCoordinator<ID>