Adapter / Animation / RecyclerView

RecyclerView Animations – Add & Remove Items

RecyclerView is a really useful way of displaying content in list form, particularly when the content is dynamic and / or there are large numbers of items. One thing that can be really useful is that we get some really nice animations for free provided we implement our Adapter correctly. For those that have converted from ListView there is a tendency to follow the same usage patterns when updating the data, but this will not get the best out of RecyclerView. In this short series we’ll take a look at the right way to modify the contents of a RecyclerView.Adapter in order to get these animations for free.

Let’s begin by creating a simple RecyclerView implementation. We’ll have a simple text item which will have some buttons to add and remove items. The add button will insert a new item at the current position, and the remove button will remove the current item. There is also a button in the ActionBar to append a new item – this is useful when we have no items in the list. Much of the code is fairly standard, so I won’t bother displaying it here. The important part is the Adapter:

class MyAdapter(private val string: String) : RecyclerView.Adapter() {
    private val items: MutableList = mutableListOf()

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ViewHolder =
            LayoutInflater.from(parent.context)
                    .inflate(R.layout.list_item, parent, false)
                    .run {
                        ViewHolder(this)
                    }

    override fun getItemCount(): Int = items.size

    fun appendItem(newString: String) =
            items.add(uniqueString(newString)).also {
                notifyDataSetChanged()
            }

    override fun onBindViewHolder(holder: ViewHolder, position: Int) {
        with(holder) {
            bind(items[position])
        }
    }

    private fun uniqueString(base: String) =
            "$base ${(Math.random() * 1000).toInt()}"

    inner class ViewHolder(
            itemView: View,
            private val textView: TextView = itemView.findViewById(android.R.id.text1),
            upButton: View = itemView.findViewById(R.id.up),
            downButton: View = itemView.findViewById(R.id.down)
    ) : RecyclerView.ViewHolder(itemView) {

        init {
            addButton.setOnClickListener(insert())
            removeButton.setOnClickListener(remove())
        }

        private fun insert(): (View) -> Unit = {
            layoutPosition.also { currentPosition ->
                items.add(currentPosition, uniqueString(string))
                notifyDataSetChanged()
            }
        }

        private fun remove(): (View) -> Unit = {
            layoutPosition.also { currentPosition ->
                items.removeAt(currentPosition)
                notifyDataSetChanged()
            }
        }

        fun bind(text: String) {
            textView.text = text
        }
    }
}

The key parts are the highlighted sections which are the functions which handle adding new list items, and deleting them. The pattern that we need to use is to alter the underlying list in some way (in this case we add or remove String objects from the items list). Then we call notifyDataSetChanged() which informs the RecyclerView that something has changed and it updates the list. If we don’t call this then the update is not shown.

If we run this we see the basic behaviour:

We can see the basic add and remove behaviour, but no nice animations.

Although the basic principle that we’ve used here is fundamentally sound, it is something that I have seen quite often particularly from those who are experienced with using ListView. However, it does not leverage the full power of RecyclerView. However it only take a couple of minor changes to fix this. What can be improved is the call to notifyDataSetChanged() and this is why many people who convert from ListView fall in to this trap: because that’s the correct way to trigger an update of the ListView. It certainly works with RecyclerView but it’s actually quite a bad idea for a couple of reason. Firstly it is going to trigger a full refresh of all of the list items; and secondly the RecyclerView assume that everything has changed so is unable to infer any small changes which could be animated.

The fix is to be rather more specific about what has changed. In the appendItem() function we can do this instead:

fun appendItem(newString: String) =
        items.add(uniqueString(newString)).also {
            notifyItemInserted(itemCount - 1)
        }

Rather than use notifyDataSetChanged() we instead call notifyItemInserted() with the index of the newly inserted item string. We can also do the same thing for the buttons on each item:

private fun insert(): (View) -> Unit = {
    layoutPosition.also { currentPosition ->
        items.add(currentPosition, uniqueString(string))
        notifyItemInserted(currentPosition)
    }
}

private fun remove(): (View) -> Unit = {
    layoutPosition.also { currentPosition ->
        items.removeAt(currentPosition)
        notifyItemRemoved(currentPosition)
    }
}

The only difference here is that in remove() we call notifyItemRemoved() instead.

By being more specific about what has actually changed within the Adapter items the RecyclerView is not only more efficient because it only updates what has changed, but it also provides it with enough information to animate those changes:

It is worth bearing in mind that because this is based upon a support library, it is fully backward compatible. Here’s the same code running on an Jelly Bean (API16) emulator:

That is the basic principle at work: Be specific about what has changed and RecyclerView gives you a lot more, and we’ll explore this further in the next article.

The source code for this article is available here.

© 2018, Mark Allison. All rights reserved.

Copyright © 2018 Styling Android. All Rights Reserved.
Information about how to reuse or republish this work may be available at http://blog.stylingandroid.com/license-information.

5 Comments

  1. Hi! Nice article!
    But I’ve got a question:
    When you deleted Item, all elements below “slided” up for one position. That’s fine when it’s a normal list.
    But in case of a reverted list, we want elements that are ABOVE of the deleted item to “slide” down for one position.
    I’m out of ideas how to achieve this:(

  2. You can also `Adapter.setHasStableIds(true)` (and implement `Adapter.getItemId()`) to have `notifyDataSetChanged()` animated. I believe it is less efficient then tracking changes with `notifyItem*` but it can be useful.

  3. Hi Mark,

    Great tutorial.
    I am trying to port this to Java as I dont know Kotlin yet. Besides giving me an opportunity to get familiar with Kotlin syntax, I am having trouble with the syntax for the insert() and remove() onClickListeners. Where does “layoutPosition” come from and what is its function.

    Thank you

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.