# DefaultItemAnimator
added in [version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
belongs to Maven artifact com.android.support:recyclerview-v7:28.0.0-alpha1
Summary: [Inherited Constants](https://developer.android.com/reference/android/support/v7/widget/DefaultItemAnimator#inhconstants) \| [Ctors](https://developer.android.com/reference/android/support/v7/widget/DefaultItemAnimator#pubctors) \| [Methods](https://developer.android.com/reference/android/support/v7/widget/DefaultItemAnimator#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/support/v7/widget/DefaultItemAnimator#inhmethods) \| [\[Expand All\]](https://developer.android.com/reference/android/support/v7/widget/DefaultItemAnimator#)
# DefaultItemAnimator
| This package is part of the Android [support library](https://developer.android.com/topic/libraries/support-library) which is no longer maintained. The support library has been superseded by [AndroidX](https://developer.android.com/jetpack/androidx) which is part of [Jetpack](https://developer.android.com/jetpack). We recommend using the AndroidX libraries in all new projects. You should also consider [migrating](https://developer.android.com/jetpack/androidx/migrate) existing projects to AndroidX. To find the AndroidX class that maps to this deprecated class, see the AndroidX support library [class
| mappings](https://developer.android.com/jetpack/androidx/migrate/class-mappings).
`
public
class
DefaultItemAnimator
`
`
`
`
`
`
extends `[SimpleItemAnimator](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator)`
`
`
`
|---|---|---|-----------------------------------------------|
| java.lang.Object ||||
| ↳ | [android.support.v7.widget.RecyclerView.ItemAnimator](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator) |||
| | ↳ | [android.support.v7.widget.SimpleItemAnimator](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator) ||
| | | ↳ | android.support.v7.widget.DefaultItemAnimator |
))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` viewHolder, List payloads) ` When an item is changed, ItemAnimator can decide whether it wants to re-use the same ViewHolder for animations or RecyclerView should create a copy of the item and ItemAnimator will use both to run the animation (e.g. If the payload list is not empty, DefaultItemAnimator returns `true`. |
| ` void` | ` `[endAnimation](https://developer.android.com/reference/android/support/v7/widget/DefaultItemAnimator#endAnimation(android.support.v7.widget.RecyclerView.ViewHolder))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` item) ` Method called when an animation on a view should be ended immediately. |
| ` void` | ` `[endAnimations](https://developer.android.com/reference/android/support/v7/widget/DefaultItemAnimator#endAnimations())`() ` Method called when all item animations should be ended immediately. |
| ` boolean` | ` `[isRunning](https://developer.android.com/reference/android/support/v7/widget/DefaultItemAnimator#isRunning())`() ` Method which returns whether there are any item animations currently running. |
| ` void` | ` `[runPendingAnimations](https://developer.android.com/reference/android/support/v7/widget/DefaultItemAnimator#runPendingAnimations())`() ` Called when there are pending animations waiting to be started. |
| ### Inherited methods |
|-----------------------|---|
| [](https://developer.android.com/reference/android/support/v7/widget/DefaultItemAnimator#)From class ` `[android.support.v7.widget.SimpleItemAnimator](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator)` ` |---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` abstract boolean` | ` `[animateAdd](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator#animateAdd(android.support.v7.widget.RecyclerView.ViewHolder))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` holder) ` Called when an item is added to the RecyclerView. | | ` boolean` | ` `[animateAppearance](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator#animateAppearance(android.support.v7.widget.RecyclerView.ViewHolder, android.support.v7.widget.RecyclerView.ItemAnimator.ItemHolderInfo, android.support.v7.widget.RecyclerView.ItemAnimator.ItemHolderInfo))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` viewHolder, `[RecyclerView.ItemAnimator.ItemHolderInfo](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator.ItemHolderInfo)` preLayoutInfo, `[RecyclerView.ItemAnimator.ItemHolderInfo](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator.ItemHolderInfo)` postLayoutInfo) ` Called by the RecyclerView when a ViewHolder is added to the layout. | | ` abstract boolean` | ` `[animateChange](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator#animateChange(android.support.v7.widget.RecyclerView.ViewHolder, android.support.v7.widget.RecyclerView.ViewHolder, int, int, int, int))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` oldHolder, `[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` newHolder, int fromLeft, int fromTop, int toLeft, int toTop) ` Called when an item is changed in the RecyclerView, as indicated by a call to [notifyItemChanged(int)](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.Adapter#notifyItemChanged(int)) or [notifyItemRangeChanged(int, int)](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.Adapter#notifyItemRangeChanged(int, int)). | | ` boolean` | ` `[animateChange](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator#animateChange(android.support.v7.widget.RecyclerView.ViewHolder, android.support.v7.widget.RecyclerView.ViewHolder, android.support.v7.widget.RecyclerView.ItemAnimator.ItemHolderInfo, android.support.v7.widget.RecyclerView.ItemAnimator.ItemHolderInfo))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` oldHolder, `[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` newHolder, `[RecyclerView.ItemAnimator.ItemHolderInfo](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator.ItemHolderInfo)` preInfo, `[RecyclerView.ItemAnimator.ItemHolderInfo](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator.ItemHolderInfo)` postInfo) ` Called by the RecyclerView when an adapter item is present both before and after the layout and RecyclerView has received a [notifyItemChanged(int)](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.Adapter#notifyItemChanged(int)) call for it. | | ` boolean` | ` `[animateDisappearance](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator#animateDisappearance(android.support.v7.widget.RecyclerView.ViewHolder, android.support.v7.widget.RecyclerView.ItemAnimator.ItemHolderInfo, android.support.v7.widget.RecyclerView.ItemAnimator.ItemHolderInfo))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` viewHolder, `[RecyclerView.ItemAnimator.ItemHolderInfo](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator.ItemHolderInfo)` preLayoutInfo, `[RecyclerView.ItemAnimator.ItemHolderInfo](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator.ItemHolderInfo)` postLayoutInfo) ` Called by the RecyclerView when a ViewHolder has disappeared from the layout. | | ` abstract boolean` | ` `[animateMove](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator#animateMove(android.support.v7.widget.RecyclerView.ViewHolder, int, int, int, int))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` holder, int fromX, int fromY, int toX, int toY) ` Called when an item is moved in the RecyclerView. | | ` boolean` | ` `[animatePersistence](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator#animatePersistence(android.support.v7.widget.RecyclerView.ViewHolder, android.support.v7.widget.RecyclerView.ItemAnimator.ItemHolderInfo, android.support.v7.widget.RecyclerView.ItemAnimator.ItemHolderInfo))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` viewHolder, `[RecyclerView.ItemAnimator.ItemHolderInfo](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator.ItemHolderInfo)` preInfo, `[RecyclerView.ItemAnimator.ItemHolderInfo](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator.ItemHolderInfo)` postInfo) ` Called by the RecyclerView when a ViewHolder is present in both before and after the layout and RecyclerView has not received a [notifyItemChanged(int)](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.Adapter#notifyItemChanged(int)) call for it or a [notifyDataSetChanged()](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.Adapter#notifyDataSetChanged()) call. | | ` abstract boolean` | ` `[animateRemove](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator#animateRemove(android.support.v7.widget.RecyclerView.ViewHolder))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` holder) ` Called when an item is removed from the RecyclerView. | | ` boolean` | ` `[canReuseUpdatedViewHolder](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator#canReuseUpdatedViewHolder(android.support.v7.widget.RecyclerView.ViewHolder))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` viewHolder) ` When an item is changed, ItemAnimator can decide whether it wants to re-use the same ViewHolder for animations or RecyclerView should create a copy of the item and ItemAnimator will use both to run the animation (e.g. | | ` final void` | ` `[dispatchAddFinished](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator#dispatchAddFinished(android.support.v7.widget.RecyclerView.ViewHolder))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` item) ` Method to be called by subclasses when an add animation is done. | | ` final void` | ` `[dispatchAddStarting](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator#dispatchAddStarting(android.support.v7.widget.RecyclerView.ViewHolder))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` item) ` Method to be called by subclasses when an add animation is being started. | | ` final void` | ` `[dispatchChangeFinished](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator#dispatchChangeFinished(android.support.v7.widget.RecyclerView.ViewHolder, boolean))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` item, boolean oldItem) ` Method to be called by subclasses when a change animation is done. | | ` final void` | ` `[dispatchChangeStarting](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator#dispatchChangeStarting(android.support.v7.widget.RecyclerView.ViewHolder, boolean))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` item, boolean oldItem) ` Method to be called by subclasses when a change animation is being started. | | ` final void` | ` `[dispatchMoveFinished](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator#dispatchMoveFinished(android.support.v7.widget.RecyclerView.ViewHolder))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` item) ` Method to be called by subclasses when a move animation is done. | | ` final void` | ` `[dispatchMoveStarting](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator#dispatchMoveStarting(android.support.v7.widget.RecyclerView.ViewHolder))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` item) ` Method to be called by subclasses when a move animation is being started. | | ` final void` | ` `[dispatchRemoveFinished](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator#dispatchRemoveFinished(android.support.v7.widget.RecyclerView.ViewHolder))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` item) ` Method to be called by subclasses when a remove animation is done. | | ` final void` | ` `[dispatchRemoveStarting](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator#dispatchRemoveStarting(android.support.v7.widget.RecyclerView.ViewHolder))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` item) ` Method to be called by subclasses when a remove animation is being started. | | ` boolean` | ` `[getSupportsChangeAnimations](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator#getSupportsChangeAnimations())`() ` Returns whether this ItemAnimator supports animations of change events. | | ` void` | ` `[onAddFinished](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator#onAddFinished(android.support.v7.widget.RecyclerView.ViewHolder))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` item) ` Called when an add animation has ended on the given ViewHolder. | | ` void` | ` `[onAddStarting](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator#onAddStarting(android.support.v7.widget.RecyclerView.ViewHolder))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` item) ` Called when an add animation is being started on the given ViewHolder. | | ` void` | ` `[onChangeFinished](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator#onChangeFinished(android.support.v7.widget.RecyclerView.ViewHolder, boolean))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` item, boolean oldItem) ` Called when a change animation has ended on the given ViewHolder. | | ` void` | ` `[onChangeStarting](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator#onChangeStarting(android.support.v7.widget.RecyclerView.ViewHolder, boolean))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` item, boolean oldItem) ` Called when a change animation is being started on the given ViewHolder. | | ` void` | ` `[onMoveFinished](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator#onMoveFinished(android.support.v7.widget.RecyclerView.ViewHolder))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` item) ` Called when a move animation has ended on the given ViewHolder. | | ` void` | ` `[onMoveStarting](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator#onMoveStarting(android.support.v7.widget.RecyclerView.ViewHolder))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` item) ` Called when a move animation is being started on the given ViewHolder. | | ` void` | ` `[onRemoveFinished](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator#onRemoveFinished(android.support.v7.widget.RecyclerView.ViewHolder))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` item) ` Called when a remove animation has ended on the given ViewHolder. | | ` void` | ` `[onRemoveStarting](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator#onRemoveStarting(android.support.v7.widget.RecyclerView.ViewHolder))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` item) ` Called when a remove animation is being started on the given ViewHolder. | | ` void` | ` `[setSupportsChangeAnimations](https://developer.android.com/reference/android/support/v7/widget/SimpleItemAnimator#setSupportsChangeAnimations(boolean))`(boolean supportsChangeAnimations) ` Sets whether this ItemAnimator supports animations of item change events. | ||
| [](https://developer.android.com/reference/android/support/v7/widget/DefaultItemAnimator#)From class ` `[android.support.v7.widget.RecyclerView.ItemAnimator](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator)` ` |-----------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` abstract boolean` | ` `[animateAppearance](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#animateAppearance(android.support.v7.widget.RecyclerView.ViewHolder, android.support.v7.widget.RecyclerView.ItemAnimator.ItemHolderInfo, android.support.v7.widget.RecyclerView.ItemAnimator.ItemHolderInfo))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` viewHolder, `[RecyclerView.ItemAnimator.ItemHolderInfo](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator.ItemHolderInfo)` preLayoutInfo, `[RecyclerView.ItemAnimator.ItemHolderInfo](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator.ItemHolderInfo)` postLayoutInfo) ` Called by the RecyclerView when a ViewHolder is added to the layout. | | ` abstract boolean` | ` `[animateChange](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#animateChange(android.support.v7.widget.RecyclerView.ViewHolder, android.support.v7.widget.RecyclerView.ViewHolder, android.support.v7.widget.RecyclerView.ItemAnimator.ItemHolderInfo, android.support.v7.widget.RecyclerView.ItemAnimator.ItemHolderInfo))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` oldHolder, `[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` newHolder, `[RecyclerView.ItemAnimator.ItemHolderInfo](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator.ItemHolderInfo)` preLayoutInfo, `[RecyclerView.ItemAnimator.ItemHolderInfo](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator.ItemHolderInfo)` postLayoutInfo) ` Called by the RecyclerView when an adapter item is present both before and after the layout and RecyclerView has received a [notifyItemChanged(int)](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.Adapter#notifyItemChanged(int)) call for it. | | ` abstract boolean` | ` `[animateDisappearance](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#animateDisappearance(android.support.v7.widget.RecyclerView.ViewHolder, android.support.v7.widget.RecyclerView.ItemAnimator.ItemHolderInfo, android.support.v7.widget.RecyclerView.ItemAnimator.ItemHolderInfo))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` viewHolder, `[RecyclerView.ItemAnimator.ItemHolderInfo](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator.ItemHolderInfo)` preLayoutInfo, `[RecyclerView.ItemAnimator.ItemHolderInfo](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator.ItemHolderInfo)` postLayoutInfo) ` Called by the RecyclerView when a ViewHolder has disappeared from the layout. | | ` abstract boolean` | ` `[animatePersistence](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#animatePersistence(android.support.v7.widget.RecyclerView.ViewHolder, android.support.v7.widget.RecyclerView.ItemAnimator.ItemHolderInfo, android.support.v7.widget.RecyclerView.ItemAnimator.ItemHolderInfo))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` viewHolder, `[RecyclerView.ItemAnimator.ItemHolderInfo](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator.ItemHolderInfo)` preLayoutInfo, `[RecyclerView.ItemAnimator.ItemHolderInfo](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator.ItemHolderInfo)` postLayoutInfo) ` Called by the RecyclerView when a ViewHolder is present in both before and after the layout and RecyclerView has not received a [notifyItemChanged(int)](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.Adapter#notifyItemChanged(int)) call for it or a [notifyDataSetChanged()](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.Adapter#notifyDataSetChanged()) call. | | ` boolean` | ` `[canReuseUpdatedViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#canReuseUpdatedViewHolder(android.support.v7.widget.RecyclerView.ViewHolder, java.util.List))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` viewHolder, List payloads) ` When an item is changed, ItemAnimator can decide whether it wants to re-use the same ViewHolder for animations or RecyclerView should create a copy of the item and ItemAnimator will use both to run the animation (e.g. | | ` boolean` | ` `[canReuseUpdatedViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#canReuseUpdatedViewHolder(android.support.v7.widget.RecyclerView.ViewHolder))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` viewHolder) ` When an item is changed, ItemAnimator can decide whether it wants to re-use the same ViewHolder for animations or RecyclerView should create a copy of the item and ItemAnimator will use both to run the animation (e.g. | | ` final void` | ` `[dispatchAnimationFinished](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#dispatchAnimationFinished(android.support.v7.widget.RecyclerView.ViewHolder))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` viewHolder) ` Method to be called by subclasses when an animation is finished. | | ` final void` | ` `[dispatchAnimationStarted](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#dispatchAnimationStarted(android.support.v7.widget.RecyclerView.ViewHolder))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` viewHolder) ` Method to be called by subclasses when an animation is started. | | ` final void` | ` `[dispatchAnimationsFinished](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#dispatchAnimationsFinished())`() ` This method should be called by ItemAnimator implementations to notify any listeners that all pending and active item animations are finished. | | ` abstract void` | ` `[endAnimation](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#endAnimation(android.support.v7.widget.RecyclerView.ViewHolder))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` item) ` Method called when an animation on a view should be ended immediately. | | ` abstract void` | ` `[endAnimations](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#endAnimations())`() ` Method called when all item animations should be ended immediately. | | ` long` | ` `[getAddDuration](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#getAddDuration())`() ` Gets the current duration for which all add animations will run. | | ` long` | ` `[getChangeDuration](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#getChangeDuration())`() ` Gets the current duration for which all change animations will run. | | ` long` | ` `[getMoveDuration](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#getMoveDuration())`() ` Gets the current duration for which all move animations will run. | | ` long` | ` `[getRemoveDuration](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#getRemoveDuration())`() ` Gets the current duration for which all remove animations will run. | | ` abstract boolean` | ` `[isRunning](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#isRunning())`() ` Method which returns whether there are any item animations currently running. | | ` final boolean` | ` `[isRunning](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#isRunning(android.support.v7.widget.RecyclerView.ItemAnimator.ItemAnimatorFinishedListener))`(`[RecyclerView.ItemAnimator.ItemAnimatorFinishedListener](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator.ItemAnimatorFinishedListener)` listener) ` Like [isRunning()](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#isRunning()), this method returns whether there are any item animations currently running. | | ` `[RecyclerView.ItemAnimator.ItemHolderInfo](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator.ItemHolderInfo) | ` `[obtainHolderInfo](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#obtainHolderInfo())`() ` Returns a new [RecyclerView.ItemAnimator.ItemHolderInfo](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator.ItemHolderInfo) which will be used to store information about the ViewHolder. | | ` void` | ` `[onAnimationFinished](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#onAnimationFinished(android.support.v7.widget.RecyclerView.ViewHolder))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` viewHolder) ` Called after [dispatchAnimationFinished(ViewHolder)](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#dispatchAnimationFinished(android.support.v7.widget.RecyclerView.ViewHolder)) is called by the ItemAnimator. | | ` void` | ` `[onAnimationStarted](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#onAnimationStarted(android.support.v7.widget.RecyclerView.ViewHolder))`(`[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` viewHolder) ` Called when a new animation is started on the given ViewHolder. | | ` `[RecyclerView.ItemAnimator.ItemHolderInfo](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator.ItemHolderInfo) | ` `[recordPostLayoutInformation](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#recordPostLayoutInformation(android.support.v7.widget.RecyclerView.State, android.support.v7.widget.RecyclerView.ViewHolder))`(`[RecyclerView.State](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.State)` state, `[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` viewHolder) ` Called by the RecyclerView after the layout is complete. | | ` `[RecyclerView.ItemAnimator.ItemHolderInfo](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator.ItemHolderInfo) | ` `[recordPreLayoutInformation](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#recordPreLayoutInformation(android.support.v7.widget.RecyclerView.State, android.support.v7.widget.RecyclerView.ViewHolder, int, java.util.List))`(`[RecyclerView.State](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.State)` state, `[RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)` viewHolder, int changeFlags, List payloads) ` Called by the RecyclerView before the layout begins. | | ` abstract void` | ` `[runPendingAnimations](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#runPendingAnimations())`() ` Called when there are pending animations waiting to be started. | | ` void` | ` `[setAddDuration](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#setAddDuration(long))`(long addDuration) ` Sets the duration for which all add animations will run. | | ` void` | ` `[setChangeDuration](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#setChangeDuration(long))`(long changeDuration) ` Sets the duration for which all change animations will run. | | ` void` | ` `[setMoveDuration](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#setMoveDuration(long))`(long moveDuration) ` Sets the duration for which all move animations will run. | | ` void` | ` `[setRemoveDuration](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#setRemoveDuration(long))`(long removeDuration) ` Sets the duration for which all remove animations will run. | ||
| [](https://developer.android.com/reference/android/support/v7/widget/DefaultItemAnimator#)From class ` java.lang.Object ` |-------------------|-------------------------------| | ` Object` | ` clone() ` | | ` boolean` | ` equals(Object arg0) ` | | ` void` | ` finalize() ` | | ` final Class` | ` getClass() ` | | ` int` | ` hashCode() ` | | ` final void` | ` notify() ` | | ` final void` | ` notifyAll() ` | | ` String` | ` toString() ` | | ` final void` | ` wait(long arg0, int arg1) ` | | ` final void` | ` wait(long arg0) ` | | ` final void` | ` wait() ` | ||
## Public constructors
### DefaultItemAnimator
added in [version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
DefaultItemAnimator ()
```
payloads)
```
When an item is changed, ItemAnimator can decide whether it wants to re-use
the same ViewHolder for animations or RecyclerView should create a copy of the
item and ItemAnimator will use both to run the animation (e.g. cross-fade).
Note that this method will only be called if the [RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder) still has the same
type ([getItemViewType(int)](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.Adapter#getItemViewType(int))). Otherwise, ItemAnimator will always receive
both [RecyclerView.ViewHolder](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ViewHolder)s in the
[animateChange(ViewHolder, ViewHolder, ItemHolderInfo, ItemHolderInfo)](https://developer.android.com/reference/android/support/v7/widget/RecyclerView.ItemAnimator#animateChange(android.support.v7.widget.RecyclerView.ViewHolder, android.support.v7.widget.RecyclerView.ViewHolder, android.support.v7.widget.RecyclerView.ItemAnimator.ItemHolderInfo, android.support.v7.widget.RecyclerView.ItemAnimator.ItemHolderInfo)) method.
If the payload list is not empty, DefaultItemAnimator returns `true`.
When this is the case:
- If you override [animateChange(ViewHolder, ViewHolder, int, int, int, int)](https://developer.android.com/reference/android/support/v7/widget/DefaultItemAnimator#animateChange(android.support.v7.widget.RecyclerView.ViewHolder, android.support.v7.widget.RecyclerView.ViewHolder, int, int, int, int)), both ViewHolder arguments will be the same instance.
- If you are not overriding [animateChange(ViewHolder, ViewHolder, int, int, int, int)](https://developer.android.com/reference/android/support/v7/widget/DefaultItemAnimator#animateChange(android.support.v7.widget.RecyclerView.ViewHolder, android.support.v7.widget.RecyclerView.ViewHolder, int, int, int, int)), then DefaultItemAnimator will call [animateMove(ViewHolder, int, int, int, int)](https://developer.android.com/reference/android/support/v7/widget/DefaultItemAnimator#animateMove(android.support.v7.widget.RecyclerView.ViewHolder, int, int, int, int)) and run a move animation instead.
)) method **if** this method returns `true`.