Kotlin android recyclerview example

RecyclerView

Компонент RecyclerView появился в Android 5.0 Lollipop и находится в разделе Containers. Для простоты буду называть его списком, хотя на самом деле это универсальный элемент управления с большими возможностями.

Раньше для отображения прокручиваемого списка использовался ListView. Со временем у него обнаружилось множество недостатков, которые было трудно исправить. Тогда решили создать новый элемент с нуля.

Вначале это был сырой продукт, потом его доработали. На данном этапе можно считать, что он стал полноценной заменой устаревшего ListView.

Схематично работу RecyclerView можно представить следующим образом. На экране отображаются видимые элементы списка. Когда при прокрутке списка верхний элемент уходит за пределы экрана и становится невидимым, его содержимое очищается. При этом сам «чистый» элемент помещается вниз экрана и заполняется новыми данными, иными словами переиспользуется, отсюда название Recycle.

Компонент RecyclerView не является родственником ListView и относится к семейству ViewGroup. Он часто используется как замена ListView, но его возможности шире.

Следует сказать, что при работе с ним приходится писать много кода, который пугает новичков. Если с RecyclerView работать не постоянно, то порой забываются детали и сложно вспомнить необходимые шаги. Многие просто сохраняют отдельные шаблоны и копируют в разные проекты.

Внешний вид можно представить не только в виде обычного списка, но и в виде сетки. При необходимости можно быстро переключиться между разными типами отображения.

Для размещения своих дочерних элементов используется специальный менеджер макетов LayoutManager. Он может быть трёх видов.

• LinearLayoutManager — дочерние элементы размещаются вертикально (как в ListView) или горизонтально
• GridLayoutManager — дочерние элементы размещаются в сетке, как в GridView
• StaggeredGridLayoutManager — неравномерная сетка

Можно создать собственный менеджер на основе RecyclerView.LayoutManager.

RecyclerView.ItemDecoration позволяет работать с дочерними элементами: отступы, внешний вид.

ItemAnimator — отвечает за анимацию элементов при добавлении, удалении и других операций.

RecyclerView.Adapter связывает данные с компонентом и отслеживает изменения.

• notifyItemInserted(), notifyItemRemoved(), notifyItemChanged() — методы, отслеживающие добавление, удаление или изменение позиции одного элемента
• notifyItemRangeInserted(), notifyItemRangeRemoved(), notifyItemRangeChanged() — методы, отслеживающие изменение порядка элеметов

Стандартный метод notifyDataSetChanged() поддерживается, но он не приводит к внешнему изменению элементов на экране.

Программисты со стажем знают, что для создания «правильного» ListView нужно было создавать класс ViewHolder. В старых списках его можно было игнорировать. Теперь это стало необходимым условием.

Общая модель работы компонента.

Мы рассмотрим только базовый пример для быстрого знакомства. В реальных проектах примеры будут гораздо сложнее, чтобы обеспечить другие функциональные возможности — обработка жестов, анимация, динамическое удаление и добавление элементов.

Размещаем компонент в макете экрана через панель инструментов. Но сначала добавим зависимость.

 implementation 'androidx.recyclerview:recyclerview:1.2.1' 

Создадим макет для отдельного элемента списка. Варианты могут быть самыми разными — можно использовать один TextView для отображения строк (имена котов), можно использовать связку ImageView и TextView (имена котов и их наглые морды). Мы возьмём для примера две текстовые метки. Создадим новый файл res/layout/recyclerview_item.xml.

Добавим компонент в разметку экрана активности.

Если вы хотите видеть макет в режиме дизайна, то добавьте в RecyclerView атрибут tools:listitem=»@layout/recyclerview_item». Тогда вам будет доступен предварительный просмотр.

Существуют и другие полезные атрибуты, которые вы можете применить к компоненту. Например, вы можете добавить полосу прокрутки:

 android:scrollbars="horizontal" 

Минимальный код для запуска.

 // в onCreate() setContentView(R.layout.activity_main) val recyclerView: RecyclerView = findViewById(R.id.recyclerView) recyclerView.layoutManager = LinearLayoutManager(this) 

Пока ничего сложного, но выводить такой список ничего не будет. Нужен адаптер и данные для отображения. В адаптере описывается способ связи между данными и компонентом.

Начнём по порядку, чтобы запомнить последовательность. Для начала создадим обычный класс и в конструкторе передадим список строк. Список будет содержать имена котов.

 package ru.alexanderklimov.recyclerviewdemo class CustomRecyclerAdapter(private val names: List)

Класс MyViewHolder на основе ViewHolder служит для оптимизации ресурсов. Он служит своеобразным контейнером для всех компонентов, которые входят в элемент списка. При этом RecyclerView создаёт ровно столько контейнеров, сколько нужно для отображения на экране. Новый класс добавим в состав нашего созданного ранее класса. В скобках указываем название для элемента списка на основе View и этот же параметр указываем и для RecycleView.ViewHolder.

 package ru.alexanderklimov.recyclerviewdemo import android.view.View import androidx.recyclerview.widget.RecyclerView class CustomRecyclerAdapter(private val names: List) < class MyViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) > 

В созданном классе-контейнере нужно просто перечислить используемые компоненты из макета для отдельного элемента списка. В нашем примере задействованы два TextView, инициализируем их через идентификаторы.

 package ru.alexanderklimov.recyclerviewdemo import android.view.View import android.widget.TextView import androidx.recyclerview.widget.RecyclerView class CustomRecyclerAdapter(private val names: List) < class MyViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) < val largeTextView: TextView = itemView.findViewById(R.id.textViewLarge) val smallTextView: TextView = itemView.findViewById(R.id.textViewSmall) >> 

Создадим адаптер — наследуем наш класс от класса RecyclerView.Adapter и в качестве параметра указываем созданный нами MyViewHolder. Студия попросит реализовать три метода.

 class CustomRecyclerAdapter(private val names: List) : RecyclerView.Adapter() < class MyViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) < val largeTextView: TextView = itemView.findViewById(R.id.textViewLarge) val smallTextView: TextView = itemView.findViewById(R.id.textViewSmall) > override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): MyViewHolder < TODO("Not yet implemented") >override fun onBindViewHolder(holder: MyViewHolder, position: Int) < TODO("Not yet implemented") >override fun getItemCount(): Int > 

 // Длинный вариант override fun getItemCount(): Int < return names.size >// Короткий вариант override fun getItemCount() = names.size 

 override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): MyViewHolder

 override fun onBindViewHolder(holder: MyViewHolder, position: Int)

 package ru.alexanderklimov.recyclerviewdemo import android.view.LayoutInflater import android.view.View import android.view.ViewGroup import android.widget.TextView import androidx.recyclerview.widget.RecyclerView class CustomRecyclerAdapter(private val names: List) : RecyclerView .Adapter() < class MyViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) < val largeTextView: TextView = itemView.findViewById(R.id.textViewLarge) val smallTextView: TextView = itemView.findViewById(R.id.textViewSmall) >override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): MyViewHolder < val itemView = LayoutInflater.from(parent.context) .inflate(R.layout.recycler_item, parent, false) return MyViewHolder(itemView) >override fun onBindViewHolder(holder: MyViewHolder, position: Int) < holder.largeTextView.text = names[position] holder.smallTextView.text = "кот" >override fun getItemCount() = names.size > 

 // Если этот код работает, его написал Александр Климов, // а если нет, то не знаю, кто его писал. package ru.alexanderklimov.recyclerviewdemo import android.os.Bundle import androidx.appcompat.app.AppCompatActivity import androidx.recyclerview.widget.LinearLayoutManager import androidx.recyclerview.widget.RecyclerView class MainActivity : AppCompatActivity() < override fun onCreate(savedInstanceState: Bundle?) < super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) val recyclerView: RecyclerView = findViewById(R.id.recyclerView) recyclerView.layoutManager = LinearLayoutManager(this) recyclerView.adapter = CustomRecyclerAdapter(fillList()) >private fun fillList(): List < val data = mutableListOf() (0..30).forEach < i ->data.add("$i element") > return data > > 

  Рыжик Барсик Мурзик Мурка Васька Томасина Кристина Пушок Дымка Кузя Китти Масяня Симба  

 private fun getCatList(): List  < return this.resources.getStringArray(R.array.cat_names).toList() >recyclerView.adapter = CustomRecyclerAdapter(getCatList()) 

 recyclerView.layoutManager = LinearLayoutManager(this, LinearLayoutManager.HORIZONTAL, false)