Android expandable recyclerview animation

MotionLayout + RecyclerView = красивые анимированные списки

В этой статье я расскажу и покажу, как создавать красивые анимированные списки на основе RecyclerView и MotionLayout. Аналогичный метод я использовал в одном из своих проектов.

От переводчика: репозиторий автора статьи — https://github.com/mjmanaog/foodbuddy.
Я его форкнул, чтобы перевести. Возможно, кому-то «русская версия» подойдёт больше.

Что такое MotionLayout?

Если вкратце, то MotionLayout — это подкласс ConstraintLayout, который позволяет с помощью XML описывать движения и анимацию расположенных на нём элементов. Подробнее — в документации и вот здесь с примерами.

Шаг 1: создадим новый проект

Назовём его, как душе угодно. В качестве активити выберем Empty Activity.

Шаг 2: добавим необходимые зависимости

В gradle-файл приложения добавим:

И запустим синхронизацию (Sync Now в правом верхнем углу).

Шаг 3: создадим лэйаут

Наш будущий элемент списка будет выглядеть так:

Элемент списка RecyclerView

В папке res/layout создадим файл item_food.

Внутри он выглядит так

Шаг 4: преобразуем ConstraintLayout в MotionLayout

Чтобы преобразовать ConstraintLayout в MotionLayout:

переключитесь в режим Split или Design;

в дереве компонентов (Component Tree) щёлкните правой кнопкой мыши на корневой элемент (в данном случае — clMain);

в появившемся меню выберите Convert to MotionLayout.

Как преобразовать ConstraintLayout в MotionLayout

Теперь мы можем работать с MotionLayout.

Содержимое файла item_food поменялось

В папке res Студия создала папку xml и положила в неё файл item_food_scene.xml:

Студия предупреждает (Warnings в нижней части экрана), что у элементов ImageView не заполнен тег contentDescription. Можете проигнорировать эти сообщения, а можете добавить в XML-разметке соответствующие теги (для чего они нужны, читайте здесь).

Шаг 5: добавим анимацию на ImageView

В дереве элементов выберите ivFood (ImageView с основной картинкой);

В редакторе MotionLayout выберите end;

У выделенного элемента ivFood выделите правую (End) опорную точку и перетащите её за правую (End) границу родительского элемента;

Картинка должна встать по центру родительского элемента;

Поменяйте значение атрибутов layout_height и layout_width на 300dp.

От переводчика: начальное состояние ImageView (его положение, ширина и высота) осталось без изменений, а его конечное состояние изменилось: он встанет по центру и увеличится в размере в два раза (с 150dp до 300dp).

Шаг 6: посмотрим, что получилось

Чтобы воспроизвести анимацию, которую мы только что настроили:

В редакторе MotionLayout выделите толстую стрелку, которая соединяет прямоугольники с надписями start и end;

В редакторе ниже станет доступным блок Transition;

Нажмите кнопку Play, чтобы воспроизвести анимацию.

Шаг 7: добавим анимацию на CardView

Порядок действий схож:

В дереве компонентов выделите cardView (constraintView с заголовком, описанием, калорийностью и оценкой);

В редакторе MotionLayout выберите end;

Выделите cardView в появившемся разделе ConstraintSet;

В разделе атрибутов элемента перейдите к группе Transforms;

Поменяйте значение атрибута alpha на 0.

От переводчика: у карточки с описанием блюда конечное состояние (end) от начального (start) отличается только значением параметра alpha. В конечном состоянии она будет скрыта (и скрываться она будет плавно).

Шаг 8: добавим обработчик нажатий

Чтобы анимация включалась, надо настроить обработчик нажатий:

В разделе атрибутов под OnClick добавьте новое поле (кнопка «+»);

В параметра targetId выберите значение ivFood;

Добавьте ещё одно поле;

Для параметра ClickAction выберите значение toggle.

В результате получится такая анимация:

Шаг 9: добавим RecyclerView в activity_main.xml

Шаг 10: создадим класс и фиктивные данные для примера

Шаг 11: создадим адаптер и ViewHolder

Тут ничего экзотического нет. Используем нашу FoodModel

Шаг 12: заполним RecyclerView элементами

В результате этих несложных действий получилась такая анимация:

Она вести 11 Мб.

Ещё кое-что

В файле item_food_scene.xml содержится описание анимации, которую мы настроили. Никто не мешает вам создавать и редактировать анимации в файлах сцены вручную.

Надеюсь, материал из этой статьи кому-то окажется полезным. Будет круто, если вы узнаете из неё что-то новое.

Источник

How to make Expandable RecyclerView using Kotlin

UPDATE [November 9th, 2020]: I changed the code/tutorial completely to fix that cell height bug. Also added code to show one cell at a time

Today, I’m going to show you how to make an expandable RecyclerView with smooth animation without using any 3rd party library.

Making Expandable RecyclerView

Go to your Activity’s XML file and paste the following code to add a RecyclerView

And for the cell of the RecyclerView:

Set up your RecyclerView in your Activity (MainActivity.kt).

And for the RecyclerViewAdapter:

Extra: Expanding/Collapsing one at a time

If you want to expand/collapse only one cell at a time, you need to save the latest cell and hide it when you tap the next one.

Add the following code at the bottom of the setOnClickListener in the onBindViewHolder method:

If you have any questions, please feel free to leave a comment below

Источник

Android expandable recyclerview animation

Expandable RecyclerView

Custom RecyclerViewAdapters for expanding and collapsing groups with support for multiple view types

Let’s say you are a rock star 🎸 and you want to build an app to show a list of your favorite Genre s with a list of their top Artist s.

First, define your custom ExpandableGroup class:

Next up, let’s create the ChildViewHolder and GroupViewHolder . These are both wrappers around regular ol’ RecyclerView.ViewHolder s so implement any view inflation and binding methods you may need.

Now we are ready for the juicy part — let’s make our ExpandableRecyclerViewAdapter

By including your GroupViewHolder and ChildViewHolder in the definition of the class, you’ll see that the onCreateGroupViewHolder and onCreateChildViewHolder methods return the correct type 👍

Lastly you’ll need either an Activity or Fragment to host your adapter. Once you’ve got that up and running, all that’s left is to instantiate your fancy new GenreAdapter with a List

Saving And Restoring Expand / Collapse State

If you want to save the expand and collapse state of your adapter, you have to explicitly call through to the adapters onSaveInstanceState() and onRestoreInstanceState() in the calling Activity

Programmatic Expanding and Collapsing

The ExpandableRecyclerViewAdapter exposes methods to control the expanded and collapsed state.

First up we have the toggles, .toggleGroup(int) and .toggleGroup(ExpandableGroup) . These are handy for when you control the states explicitly.

We also expose explicit methods to control the expanding and collapsing of specific groups, .expandGroup() and .collapseGroup() . For example, to expand the first group immediately:

Adding Custom Expand / Collapse Animations

If you want to add a custom Drawable that animates based on a groups state, override the expand() and collapse() methods in your GroupViewHolder :

Listening to Expand/Collapse events

If you want register an ExpandCollapseListener outside of the adapter, you can simply call setOnGroupExpandCollapseListener on the ExpandableRecyclerViewAdapter

Multiple Child and Group Types

The MultiTypeExpandableRecyclerViewAdapter allows subclasses to implement multiple different view types for both children and groups.

Continuing with our genre example, let’s say you wanted to display regular artists differently from your favorite artists. Let’s start by making a new FavoriteArtistViewHolder

Just like the regular ArtistViewHolder , FavoriteArtistViewHolder must extends ChildViewHolder .

Next up, let’s create a subclass of MultiTypeExpandableRecyclerViewAdapter called MultiTypeGenreAdapter and let’s add two static int s representing our two artist view types:

Notice we started used values > 2. That’s because ExpandableListPosition.CHILD and ExpandableListPositon.GROUP are 1 and 2 respectively so they are already taken.

Since we only want a single view type for groups, we only need to override getChildViewType() . As getGroupViewType() will default to ExpandableListPosition.GROUP .

Since we provided custom view types for our children, we must also override isChild()

And now, just like in any other RecyclerView.Adapter in our onCreateChildViewHolder and our onBindChildViewHolder we can use the provided parameters to switch on the different view tyeps:

Expandable Check RecyclerView

An extension of expandablerecyclerview for checking single or multiple children within a group

The setup for the single and multi check versions is very similar to the expandablerecyclerview we walked through above. Here are a few of the notable differences.

Instead of ExpandableGroup you must use CheckedExpandableGroup . CheckedExpandableGroup is a subclass of ExpandableGroup that uses a SparseBooleanArray to hold onto which of it’s children are checked.

The expandablecheckrecyclerview library comes with two default implementations — SingleCheckExpandableGroup and MultiCheckExpandableGroup .

The CheckableChildRecyclerViewAdapter has a clearChoices() which un checks any currently checked children.

The CheckableChildViewHolder is a subclass of ChildViewHolder that has a Checkable widget. The Checkable interface is initially not set, so in order to see your children view states update, you must set a View that implements Checkable in your view holder.

Listening to Child Click Events

There is a custom callback for click events on children of a CheckedExpandableGroup which returns you the View of the row item that was clicked, the current checked state of the child, the containing CheckedExpandableGroup group and the index of the child that was clicked.

To see the complete code for all the above examples along with unit tests for the adapters check out the sample app. The app has the following packages:

An example of basic ExpandableRecyclerViewAdapter

An example of a CheckableChildRecyclerViewAdapter using MultiCheckExpandableGroup

An example of a CheckableChildRecyclerViewAdapter using SingleCheckExpandableGroup

An example of a MultiTypeExpandableRecyclerViewAdapter using two different child view holders

Expandable RecyclerView is Copyright (c) 2016 thoughtbot, inc. It is free software, and may be redistributed under the terms specified in the LICENSE file.

Expandable RecyclerView is maintained by @mandybess

Expandable RecyclerView is maintained and funded by thoughtbot, inc. The names and logos for thoughtbot are trademarks of thoughtbot, inc.

We love open source software! See our other projects or hire us to help build your product.

About

Custom Android RecyclerViewAdapters that collapse and expand

Источник

Expand a RecyclerView in Four Steps

Expand a RecyclerView in Four Steps

The Expandable RecyclerView library is a lightweight library that simplifies the inclusion of expandable dropdown rows in your RecyclerView. In it, you have two types of views. The parent view is the one visible by default, and it contains the children. The child view is the one that is expanded or collapsed, and will appear when a parent item is clicked.

In this post, we will implement the Expandable RecyclerView in the CriminalIntent application from our Android programming guide. We’ll be showing a more detailed view of each crime from the main list fragment.

Not familiar with RecyclerView? Bill Phillips has written two excellent blog posts on the subject.

Let’s Get it Working

Our completed demo will look like this:

Start by adding these two dependencies to your app’s build.gradle file:

All expanding and collapsing functionality is handled in the adapter, meaning that your RecyclerView is just a stock RecyclerView. All you’ll need to do to set up the Expandable RecyclerView in a layout is add a stock RecyclerView to your activity or fragment’s XML layout.

1. The ViewHolders

First, let’s create the XML layouts for our parent and child views. Our parent layout is going to include the title of the crime and a dropdown arrow to display an animation when the item is expanded or collapsed. We’ll call this layout list_item_crime_parent .

Now, onto the child layout. The child is going to contain a TextView that shows the date of the crime and a checkbox that we can click when the crime is solved. We’ll call this layout list_item_crime_child .

Now that we have both of our layouts ready, let’s set up each ViewHolder. We will create a class called CrimeParentViewHolder that extends ParentViewHolder and another class called CrimeChildViewHolder that extends ChildViewHolder .

Let’s start with CrimeParentViewHolder. Go ahead and create a public TextView and ImageButton variable for our two views, like so:

Now, onto our CrimeChildViewHolder. We’re again going to create two public variables for our views, but this time one will be a TextView and one will be a CheckBox:

Now let’s set up our parent and child objects.

2. Parents and Their Children

For our CriminalIntent example, the data that we want to display in our list items are fields of our Crime object. Since we have both a parent and a child layout, the best practice is to create a child object, separate from the parent, to hold the data that will be displayed in the child.

In this case, our parent object will be the Crime object itself. Let’s make our Crime object implement ParentObject . Implement the getter and setter methods with a list variable:

The expandable RecyclerView allows for multiple children or none, so the children need to be added as a list. You can either add the children directly in the getChildObjectList method we implemented by returning your List of children, or you can add them when we create the list of items by calling setChildObjectList with the list of respective children. I will be doing the latter in this demo.

Our child object will hold two values, a String for the date and a boolean for the solved flag:

We’ll populate each parent object with children in the final step. Now, let’s get the adapter working!

3. The Adapter

We’re going need to implement a custom adapter that extends ExpandableRecyclerAdapter. Inside our adapter, we will implement a few methods so we can populate the data in our ViewHolders.

First, let’s create a class and call it CrimeExpandableAdapter. Make it extend ExpandableRecyclerAdapter and give it our two ViewHolder type parameters in the order of

. Our header will look like this:

You’ll need to implement the four inherited methods, onCreateParentViewHolder , onBindParentViewHolder , onCreateChildViewHolder and onBindChildViewHolder . Go ahead and implement the default constructor that will take in a Context and a List of ParentObjects.

In our constructor, let’s get access to the LayoutInflater and call it mInflater. This will be used in our onCreateParentViewHolder and onCreateChildViewHolder to inflate the layouts we created earlier. In our constructor, add mInflater = LayoutInflater.from(context); . This will create a layout inflater for us.

Now, let’s create our views and add them to the custom ViewHolders we made earlier. In onCreateParentViewHolder , let’s replace the return null line with these two lines:

Let’s now do the same as we did in onCreateParentViewHolder , but adjust for our CrimeChildViewHolder. Again, replace return null with these two lines, but this time in onCreateChildViewHolder :

To finish off our adapter, let’s work on our onBindViewHolder methods, starting with onBindParentViewHolder . In onBindParentViewHolder , three variables are passed in: the viewholder we created in onCreateParentViewHolder , the position of the item and the parent object associated with that position. We’re going to need to cast the passed parent object to our parent object type (which, as you recall, is our Crime object). Let’s make our onBindParentViewHolder look like this:

Finally, we will set up our CrimeChildViewHolder. Recall that our CrimeChildViewHolder contains a TextView for a date and a CheckBox to indicate whether the crime is solved. Our onBindChildViewHolder will look like this:

Now our adapter is ready to roll. Let’s finish this all up!

4. Tying it all together

Let’s head back to our main fragment, where we are hosting the RecyclerView. Make sure you find the RecyclerView in your layout and set its layout manager to a new LinearLayoutManager .

I went ahead and created a simple method to generate each of our Crime objects and attach their children. You can add this method in your Fragment:

Another option is to create a new list of children directly in your Crime object and set that to be the childrenList. A third option would be to create a list of children in getChildObjectList and return that list.

Now we can add the following lines to our onCreateView method:

Note that the list you pass into your adapter must be of the type ParentObject.

The setCustomParentAnimationView allows for the arrow in the parent layout to rotate on expand/collapse and setParentClickableAnimationDefaultDuration gives it a default rotation time of 200 milliseconds. setParentAndIconExpandOnClick ensures that we can click both the parent and the arrow to expand the item. You can always remove these if you don’t want an animation or custom triggering view.

Finally, set the RecyclerView’s adapter to finish it up:

That’s it! You now should have a RecyclerView that expands and collapses and has a nice rotation animation to go along with it.

Want to improve it or see more?

The library is open source, so visit the project’s GitHub page to see all the source code, then send a pull request if there are new features you’d like to add.

*Ryan Brooks was an Android intern this summer. Apply now to join our team as an intern in Fall 2015.

Steve Sparks

Steve Sparks has been a Nerd since 2011 and an electronics geek since age five. His primary focus is on iOS, watchOS, and tvOS development. He plays guitar and makes strange and terrifying contraptions. He lives in Atlanta with his family.

Schedule a call today! Our team of nerds are ready to help

Related Posts

Splash Screens: The Final Right Way

The impending release of Android 12 brings with it a group of new APIs for Android developers to learn and play with. Being a good citizen.

Coming soon: Kotlin Programming: The Big Nerd Ranch Guide, Second Edition

Kotlin has been changing at a steady pace over the years, and more and more developers are choosing Kotlin as their language of choice.

Using StateFlow over LiveData for end-to-end operations

Observing data asynchronously is such a core skill for mobile developers that you may imagine Android has a long-established set of simple APIs in.

Источник