Need help with gesture-recycler?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

285 Stars 37 Forks Other 82 Commits 2 Opened issues


This library provides swipe & drag and drop support for RecyclerView.

Services available


Need anything else?

Contributors list

# 176,753
79 commits

API Android Arsenal

Gesture Recycler

This library provides swipe & drag and drop support for RecyclerView. Based on great example from Android-ItemTouchHelper-Demo.



  • item click/long press/double tap listener
  • background views for swipeable items
  • empty view
  • undo
  • swipe
  • long press drag
  • manual mode drag
  • support for different layout managers
  • predefined drag & swipe flags for RecyclerView's layout managers
  • DiffUtil feature
  • header/footer


To use this library in your android project, just simply add the following dependency into your build.gradle

repositories {

dependencies { implementation "com.github.thesurix:gesture-recycler:1.16.0" }

How to use?

// Define your RecyclerView and adapter as usually
val manager = LinearLayoutManager(context)
recyclerView.layoutManager = manager

// Extend GestureAdapter and write your own // ViewHolder items must extend GestureViewHolder val adapter = MonthsAdapter(R.layout.linear_item) = months recyclerView.adapter = adapter

Swipe and drag & drop support:

val gestureManager = GestureManager.Builder(recyclerView)
                 // Enable swipe
                 // Enable long press drag and drop 
                 // Enable manual drag from the beginning, you need to provide View inside your GestureViewHolder
                 // Use custom gesture flags
                 // Do not use those methods if you want predefined flags for RecyclerView layout manager 
                .setSwipeFlags(ItemTouchHelper.LEFT or ItemTouchHelper.RIGHT)
                .setDragFlags(ItemTouchHelper.UP or ItemTouchHelper.DOWN)

Background view for swipeable items:

<!-- Content of the background view (you can use regular layout or ViewStub for better performance)-->
<viewstub android:id="@+id/background_view_stub" android:inflatedid="@+id/background_view" android:layout="@layout/background_view_layout" android:layout_width="match_parent" android:layout_height="match_parent"></viewstub>

<linearlayout android:id="@+id/foreground_view" android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="horizontal">
        <!-- Content of the top view -->
    // Override foregroundView, backgroundView() variables in ViewHolder to provide top and bottom view
    open val foregroundView: View
            get() = foreground

open val backgroundView: View?
        get() = background

Different background views:

<!-- Content of the background views -->
<include android:id="@+id/month_background_one" layout="@layout/first_background_item" android:layout_width="match_parent" android:layout_height="match_parent" android:visibility="gone"></include>

<include android:id="@+id/month_background_two" layout="@layout/second_background_item" android:layout_width="match_parent" android:layout_height="match_parent" android:visibility="gone"></include>

<linearlayout android:id="@+id/foreground_view" android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="horizontal">
        <!-- Content of the top view -->
    // Override foregroundView variable and getBackgroundView(direction: Int) method in ViewHolder to provide top and bottom views
    open val foregroundView: View
            get() = foreground

override fun getBackgroundView(direction: Int): View? {
        //direction can be ItemTouchHelper.LEFT, ItemTouchHelper.RIGHT, ItemTouchHelper.UP, ItemTouchHelper.DOWN
        if (direction == ItemTouchHelper.RIGHT) {
            return firstBackgroundView
        return secondBackgroundView

Data callbacks:

adapter.setDataChangeListener(object : GestureAdapter.OnDataChangeListener {
                        override fun onItemRemoved(item: MonthItem, position: Int, direction: Int) {

                    override fun onItemReorder(item: MonthItem, fromPos: Int, toPos: Int) {

Data animations:

// Support for data animations
adapter.insert(month, 5)
adapter.swap(2, 5)

// or adapter.setData(months, diffUtilCallback)

// This will interrupt pending animations = months

Item click events:

// Attach DefaultItemClickListener or implement RecyclerItemTouchListener.ItemClickListener
recyclerView.addOnItemTouchListener(RecyclerItemTouchListener(object : DefaultItemClickListener() {

        override fun onItemClick(item: MonthItem, position: Int): Boolean {
            // return true if the event is consumed
            return true

        override fun onItemLongPress(item: MonthItem, position: Int) {

        override fun onDoubleTap(item: MonthItem, position: Int): Boolean {
            // return true if the event is consumed
            return true

Empty view:

< android:id="@+id/recycler_view" android:layout_width="match_parent" android:layout_height="match_parent"></>

<!-- Define your empty view in layout -->
<textview android:id="@+id/empty_view" android:layout_width="match_parent" android:layout_height="match_parent" android:textappearance="@android:style/TextAppearance.Large" android:text="No data"></textview>
// Pass null to disable empty view
val emptyView = view.findViewById(

// or use callback adapter.setEmptyViewVisibilityListener(object : EmptyViewVisibilityListener { override fun onVisibilityChanged(visible: Boolean) { // show/hide emptyView with animation } })


// Undo last data transaction (add, insert, remove, swipe, reorder)

// Set undo stack size adapter.setUndoSize(2)


// Enabled, disable header/footer by builder

// or directly by adapter adaper.setHeaderEnabled(state) adaper.setHeaderEnabled(state)

// if header or footer is enabled then library will pass viewType (TYPE_HEADER_ITEM, TYPE_FOOTER_ITEM) // to onCreateViewHolder(parent: ViewGroup, viewType: Int) override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): GestureViewHolder { return when (viewType) { TYPE_HEADER_ITEM -> { // return header view holder } TYPE_FOOTER_ITEM -> { // return footer view holder } else -> { // return regular view holder } } }

// if getItemViewType(viewPosition: Int) is used in your adapter then // firstly call super.getItemViewType() and check if library wants to handle incoming view type override fun getItemViewType(viewPosition: Int): Int { val handledType = super.getItemViewType(viewPosition) if (handledType > 0) { // library wants to handle this case, simply return return handledType } return yourTypes }


See examples.

To do

  • examples with data binding
  • tests
  • different layouts for different swipe directions


Copyright 2021 thesurix

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.