GitHub Cards Preview

RecyclerViewSwipeExt

RecyclerViewSwipeExt is an Android Studio library that simplifies the implementation of swipe-to-delete and swipe-to-action functionality in RecyclerViews. With just a few lines of code, you can add left and right swipe gestures to your RecyclerViews, allowing users to delete or perform custom actions on items with ease. The library is highly customizable, allowing you to modify the swipe animations, icons, and colors to fit your app’s design. Get started quickly with the easy-to-follow documentation and sample code. Streamline your app’s user experience with RecyclerViewSwipeExt.

Preview

Installation

For Gradle:

Step 1: Add the JitPack repository to your build file Add it in your root build.gradle at the end of repositories:

	allprojects {
		repositories {
			maven { url 'https://jitpack.io' }
		}
	}

Step 2: Add the dependency

dependencies {
	        implementation 'com.github.JahidHasanCO:RecyclerViewSwipeExt:1.0.2'
	}

For Maven check this for your reference.

Documentation

RecyclerViewSwipeExt Extension function of RecyclerView

Parameter Details
context: Context Interface to global information about an application environment. This is an abstract class whose implementation is provided by the Android system.

To initialize RecyclerViewSwipeExt you need to call this Extension function after RecyclerView object and pass as a parameter Context and attrs by default we provide an null to attrs.

To Call this function

    recyclerview.makeLeftRightSwipeAble(this)
            .setListener(object : SwipeListener {
                override fun onSwipedLeft(position: Int) {
                    // do something
                }
                override fun onSwipedRight(position: Int) {
                    // do something
                }
            })
            .createSwipeAble()

Other Extension Methods

method Details
fun setRightBg(bg: Int) fun setRightBg(bg: Int) set right side action background. It take color resource id as a Parameter.
fun setLeftBg(bg: Int) fun setLeftBg(bg: Int) set left side action background. It take color resource id as a Parameter.
fun setRightText(text: String) fun setRightText(text: String) set right side text label. It take String as a Parameter.
fun setLeftText(text: String) fun setLeftText(text: String) set left side text label. It take String as a Parameter.
fun setRightImage(imgRef: Int) fun setRightImage(imgRef: Int) set right side icon . It take drawable resource id as a Parameter.
fun setLeftImage(imgRef: Int) fun setLeftImage(imgRef: Int) set left side icon. It take drawable resource id as a Parameter.
fun setTextColor(color: Int) fun setTextColor(color: Int) set text color. It take color resource id as a Parameter.
fun setTextSize(size: Int) fun setTextSize(size: Int) set text size. It take int as a Parameter.
fun setListener(listener: SwipeListener) fun setListener(listener: SwipeListener) set swipe listener to track swipe. It take SwipeListener object as a Parameter.

Examples

        val recyclerview = findViewById<RecyclerView>(R.id.recyclerview)
        recyclerview.layoutManager = LinearLayoutManager(this)

        val data = ArrayList<ItemsViewModel>()
        for (i in 1..20) {
            data.add(ItemsViewModel(R.drawable.baseline_outlet_24, "Item $i"))
        }

        val adapter = CustomAdapter(data)
        recyclerview.adapter = adapter

 recyclerview.makeLeftRightSwipeAble(this)
            .setListener(object : SwipeListener {
                override fun onSwipedLeft(position: Int) {
                    val deletedItem = data[position]
                    data.removeAt(position)
                    adapter.notifyItemRemoved(position)
                    Snackbar.make(
                        recyclerview,
                        "Item $position Archive",
                        Snackbar.LENGTH_LONG
                    ).setAction(
                        "Undo"
                    ) {
                        data.add(position, deletedItem)
                        adapter.notifyItemInserted(position)
                    }.show()
                }


                override fun onSwipedRight(position: Int) {
                    val deletedItem = data[position]
                    data.removeAt(position)
                    adapter.notifyItemRemoved(position)
                    Snackbar.make(
                        recyclerview,
                        "Item $position Deleted",
                        Snackbar.LENGTH_LONG
                    ).setAction(
                        "Undo"
                    ) {
                        data.add(position, deletedItem)
                        adapter.notifyItemInserted(position)
                    }.show()
                }

            })
            .createSwipeAble()

License

RecyclerViewSwipeExt is MIT licensed.

Contributing ?

If you want to contribute to this project and make it better with new ideas, your pull request is very welcomed. If you find any issue just put it in the repository issue section, thank you.

GitHub

View Github