# androidx.recyclerview.widget # androidx.recyclerview.widget *** ** * ** *** Kotlin\|[Java](https://developer.android.com/reference/androidx/recyclerview/widget/package-summary "View this page in Java") ## Interfaces |----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [AsyncListDiffer.ListListener](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/AsyncListDiffer.ListListener) | Listener for when the current List is updated. | | [ItemTouchHelper.ViewDropHandler](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/ItemTouchHelper.ViewDropHandler) | An interface which can be implemented by LayoutManager for better integration with[ItemTouchHelper](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/ItemTouchHelper). | | [ItemTouchUIUtil](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/ItemTouchUIUtil) | Utility class for[ItemTouchHelper](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/ItemTouchHelper)which handles item transformations for different API versions. | | [ListUpdateCallback](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/ListUpdateCallback) | An interface that can receive Update operations that are applied to a list. | | [RecyclerView.ChildDrawingOrderCallback](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.ChildDrawingOrderCallback) | A callback interface that can be used to alter the drawing order of RecyclerView children. | | [RecyclerView.ItemAnimator.ItemAnimatorFinishedListener](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.ItemAnimator.ItemAnimatorFinishedListener) | This interface is used to inform listeners when all pending or running animations in an ItemAnimator are finished. | | [RecyclerView.LayoutManager.LayoutPrefetchRegistry](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.LayoutManager.LayoutPrefetchRegistry) | Interface for LayoutManagers to request items to be prefetched, based on position, with specified distance from viewport, which indicates priority. | | [RecyclerView.OnChildAttachStateChangeListener](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.OnChildAttachStateChangeListener) | A Listener interface that can be attached to a RecylcerView to get notified whenever a ViewHolder is attached to or detached from RecyclerView. | | [RecyclerView.OnItemTouchListener](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.OnItemTouchListener) | An OnItemTouchListener allows the application to intercept touch events in progress at the view hierarchy level of the RecyclerView before those touch events are considered for RecyclerView's own scrolling behavior. | | [RecyclerView.RecyclerListener](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.RecyclerListener) | A RecyclerListener can be set on a RecyclerView to receive messages whenever a view is recycled. | | [RecyclerView.SmoothScroller.ScrollVectorProvider](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.SmoothScroller.ScrollVectorProvider) | An interface which is optionally implemented by custom[RecyclerView.LayoutManager](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.LayoutManager)to provide a hint to a[SmoothScroller](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.SmoothScroller)about the location of the target position. | ## Classes |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [AdapterListUpdateCallback](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/AdapterListUpdateCallback) | ListUpdateCallback that dispatches update events to the given adapter. | | [AsyncDifferConfig](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/AsyncDifferConfig) | Configuration object for[ListAdapter](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/ListAdapter),[AsyncListDiffer](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/AsyncListDiffer), and similar background-thread list diffing adapter logic. | | [AsyncDifferConfig.Builder](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/AsyncDifferConfig.Builder) | Builder class for[AsyncDifferConfig](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/AsyncDifferConfig). | | [AsyncListDiffer](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/AsyncListDiffer) | Helper for computing the difference between two lists via[DiffUtil](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/DiffUtil)on a background thread. | | [AsyncListUtil](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/AsyncListUtil) | A utility class that supports asynchronous content loading. | | [AsyncListUtil.DataCallback](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/AsyncListUtil.DataCallback) | The callback that provides data access for[AsyncListUtil](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/AsyncListUtil). | | [AsyncListUtil.ViewCallback](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/AsyncListUtil.ViewCallback) | The callback that links[AsyncListUtil](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/AsyncListUtil)with the list view. | | [BatchingListUpdateCallback](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/BatchingListUpdateCallback) | Wraps a[ListUpdateCallback](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/ListUpdateCallback)callback and batches operations that can be merged. | | [ConcatAdapter](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/ConcatAdapter) | An[Adapter](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.Adapter)implementation that presents the contents of multiple adapters in sequence. | | [ConcatAdapter.Config](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/ConcatAdapter.Config) | The configuration object for a[ConcatAdapter](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/ConcatAdapter). | | [ConcatAdapter.Config.Builder](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/ConcatAdapter.Config.Builder) | The builder for[Config](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/ConcatAdapter.Config)class. | | [DefaultItemAnimator](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/DefaultItemAnimator) | This implementation of[RecyclerView.ItemAnimator](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.ItemAnimator)provides basic animations on remove, add, and move events that happen to the items in a RecyclerView. | | [DiffUtil](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/DiffUtil) | DiffUtil is a utility class that calculates the difference between two lists and outputs a list of update operations that converts the first list into the second one. | | [DiffUtil.Callback](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/DiffUtil.Callback) | A Callback class used by DiffUtil while calculating the diff between two lists. | | [DiffUtil.DiffResult](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/DiffUtil.DiffResult) | This class holds the information about the result of a[calculateDiff](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/DiffUtil#calculateDiff(androidx.recyclerview.widget.DiffUtil.Callback,boolean))call. | | [DiffUtil.ItemCallback](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/DiffUtil.ItemCallback) | Callback for calculating the diff between two non-null items in a list. | | [DividerItemDecoration](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/DividerItemDecoration) | DividerItemDecoration is a[RecyclerView.ItemDecoration](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.ItemDecoration)that can be used as a divider between items of a[LinearLayoutManager](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/LinearLayoutManager). | | [GridLayoutManager](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/GridLayoutManager) | A[RecyclerView.LayoutManager](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.LayoutManager)implementations that lays out items in a grid. | | [GridLayoutManager.DefaultSpanSizeLookup](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/GridLayoutManager.DefaultSpanSizeLookup) | Default implementation for[SpanSizeLookup](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/GridLayoutManager.SpanSizeLookup). | | [GridLayoutManager.LayoutParams](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/GridLayoutManager.LayoutParams) | LayoutParams used by GridLayoutManager. | | [GridLayoutManager.SpanSizeLookup](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/GridLayoutManager.SpanSizeLookup) | A helper class to provide the number of spans each item occupies. | | [ItemTouchHelper](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/ItemTouchHelper) | This is a utility class to add swipe to dismiss and drag \&drop support to RecyclerView. | | [ItemTouchHelper.Callback](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/ItemTouchHelper.Callback) | This class is the contract between ItemTouchHelper and your application. | | [ItemTouchHelper.SimpleCallback](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/ItemTouchHelper.SimpleCallback) | A simple wrapper to the default Callback which you can construct with drag and swipe directions and this class will handle the flag callbacks. | | [LinearLayoutManager](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/LinearLayoutManager) | A[RecyclerView.LayoutManager](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.LayoutManager)implementation which provides similar functionality to[android.widget.ListView](https://developer.android.com/reference/android/widget/ListView.html). | | [LinearLayoutManager.LayoutChunkResult](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/LinearLayoutManager.LayoutChunkResult) | | | [LinearSmoothScroller](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/LinearSmoothScroller) | [RecyclerView.SmoothScroller](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.SmoothScroller)implementation which uses a[LinearInterpolator](https://developer.android.com/reference/android/view/animation/LinearInterpolator.html)until the target position becomes a child of the RecyclerView and then uses a[DecelerateInterpolator](https://developer.android.com/reference/android/view/animation/DecelerateInterpolator.html)to slowly approach to target position. | | [LinearSnapHelper](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/LinearSnapHelper) | Implementation of the[SnapHelper](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/SnapHelper)supporting snapping in either vertical or horizontal orientation. | | [ListAdapter](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/ListAdapter) | [RecyclerView.Adapter](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.Adapter)base class for presenting List data in a[RecyclerView](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView), including computing diffs between Lists on a background thread. | | [OrientationHelper](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/OrientationHelper) | Helper class for LayoutManagers to abstract measurements depending on the View's orientation. | | [PagerSnapHelper](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/PagerSnapHelper) | Implementation of the[SnapHelper](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/SnapHelper)supporting pager style snapping in either vertical or horizontal orientation. | | [RecyclerView](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView) | A flexible view for providing a limited window into a large data set. | | [RecyclerView.Adapter](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.Adapter) | Base class for an Adapter | | [RecyclerView.AdapterDataObserver](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.AdapterDataObserver) | Observer base class for watching changes to an[Adapter](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.Adapter). | | [RecyclerView.EdgeEffectFactory](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.EdgeEffectFactory) | EdgeEffectFactory lets you customize the over-scroll edge effect for RecyclerViews. | | [RecyclerView.ItemAnimator](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.ItemAnimator) | This class defines the animations that take place on items as changes are made to the adapter. | | [RecyclerView.ItemAnimator.ItemHolderInfo](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.ItemAnimator.ItemHolderInfo) | A simple data structure that holds information about an item's bounds. | | [RecyclerView.ItemDecoration](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.ItemDecoration) | An ItemDecoration allows the application to add a special drawing and layout offset to specific item views from the adapter's data set. | | [RecyclerView.LayoutManager](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.LayoutManager) | A`LayoutManager`is responsible for measuring and positioning item views within a`RecyclerView`as well as determining the policy for when to recycle item views that are no longer visible to the user. | | [RecyclerView.LayoutManager.Properties](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.LayoutManager.Properties) | Some general properties that a LayoutManager may want to use. | | [RecyclerView.LayoutParams](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.LayoutParams) | [LayoutParams](https://developer.android.com/reference/android/view/ViewGroup.MarginLayoutParams.html)subclass for children of[RecyclerView](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView). | | [RecyclerView.OnFlingListener](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.OnFlingListener) | This class defines the behavior of fling if the developer wishes to handle it. | | [RecyclerView.OnScrollListener](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.OnScrollListener) | An OnScrollListener can be added to a RecyclerView to receive messages when a scrolling event has occurred on that RecyclerView. | | [RecyclerView.RecycledViewPool](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.RecycledViewPool) | RecycledViewPool lets you share Views between multiple RecyclerViews. | | [RecyclerView.Recycler](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.Recycler) | A Recycler is responsible for managing scrapped or detached item views for reuse. | | [RecyclerView.SimpleOnItemTouchListener](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.SimpleOnItemTouchListener) | An implementation of[RecyclerView.OnItemTouchListener](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.OnItemTouchListener)that has empty method bodies and default return values. | | [RecyclerView.SmoothScroller](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.SmoothScroller) | Base class for smooth scrolling. | | [RecyclerView.SmoothScroller.Action](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.SmoothScroller.Action) | Holds information about a smooth scroll request by a[SmoothScroller](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.SmoothScroller). | | [RecyclerView.State](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.State) | Contains useful information about the current RecyclerView state like target scroll position or view focus. | | [RecyclerView.ViewCacheExtension](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.ViewCacheExtension) | ViewCacheExtension is a helper class to provide an additional layer of view caching that can be controlled by the developer. | | [RecyclerView.ViewHolder](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.ViewHolder) | A ViewHolder describes an item view and metadata about its place within the RecyclerView. | | [RecyclerViewAccessibilityDelegate](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerViewAccessibilityDelegate) | The AccessibilityDelegate used by RecyclerView. | | [RecyclerViewAccessibilityDelegate.ItemDelegate](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerViewAccessibilityDelegate.ItemDelegate) | The default implementation of accessibility delegate for the individual items of the RecyclerView. | | [SimpleItemAnimator](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/SimpleItemAnimator) | A wrapper class for ItemAnimator that records View bounds and decides whether it should run move, change, add or remove animations. | | [SnapHelper](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/SnapHelper) | Class intended to support snapping for a[RecyclerView](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView). | | [SortedList](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/SortedList) | A Sorted list implementation that can keep items in order and also notify for changes in the list such that it can be bound to a[RecyclerView.Adapter](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.Adapter). | | [SortedList.BatchedCallback](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/SortedList.BatchedCallback) | A callback implementation that can batch notify events dispatched by the SortedList. | | [SortedList.Callback](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/SortedList.Callback) | The class that controls the behavior of the[SortedList](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/SortedList). | | [SortedListAdapterCallback](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/SortedListAdapterCallback) | A[SortedList.Callback](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/SortedList.Callback)implementation that can bind a[SortedList](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/SortedList)to a[RecyclerView.Adapter](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.Adapter). | | [StaggeredGridLayoutManager](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/StaggeredGridLayoutManager) | A LayoutManager that lays out children in a staggered grid formation. | | [StaggeredGridLayoutManager.LayoutParams](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/StaggeredGridLayoutManager.LayoutParams) | LayoutParams used by StaggeredGridLayoutManager. | ## Annotations |--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [RecyclerView.EdgeEffectFactory.EdgeDirection](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.EdgeEffectFactory.EdgeDirection) | | | [RecyclerView.ItemAnimator.AdapterChanges](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.ItemAnimator.AdapterChanges) | The set of flags that might be passed to[recordPreLayoutInformation](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.ItemAnimator#recordPreLayoutInformation(androidx.recyclerview.widget.RecyclerView.State,androidx.recyclerview.widget.RecyclerView.ViewHolder,int,java.util.List)). | ## Enums |------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [ConcatAdapter.Config.StableIdMode](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/ConcatAdapter.Config.StableIdMode) | Defines how[ConcatAdapter](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/ConcatAdapter)handle stable ids ([hasStableIds](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.Adapter#hasStableIds())). | | [RecyclerView.Adapter.StateRestorationPolicy](https://developer.android.com/reference/kotlin/androidx/recyclerview/widget/RecyclerView.Adapter.StateRestorationPolicy) | Defines how this Adapter wants to restore its state after a view reconstruction (e.g. configuration change). |