Skip to main content

Adapter and listeners

Требования к Adapter

Для создания динамического списка элементов, например RecyclerView, необходимо создать Adapter, чтобы связать элементы со списком. Задача адаптера - Adapters provide a binding from an app-specific data set to views that are displayed within a RecyclerView из документации т.е. лишь связать данные с отображением на UI

Как должен выглядеть адаптер:

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

Пример простого адаптера

Разберем пример, у нас есть Activity со списком элементов, мы хотим, чтобы по нажатию на элемент что-то происходило, для демонстрации просто покажем Toast.

Сначала создадим ячейку нашего списка text_row_item.xml:

<?xml version="1.0" encoding="utf-8"?>
<TextView xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/textView"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text=""
tools:text="sample" />

Затем, добавим список на activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<androidx.recyclerview.widget.RecyclerView
android:id="@+id/recyclerView"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:listitem="@layout/text_row_item" />

Создадим CustomAdapter, который при создании будет принимать onClick-лямбду. Значения будут устанавливаться не в конструкторе, а просто в переменную, как только установятся - вызовется notifyDataSetChanged()

class CustomAdapter(private val onItemClick: (Int) -> Unit) :
RecyclerView.Adapter<CustomAdapter.ViewHolder>() {

var items: List<String> = emptyList()
set(value) {
field = value
notifyDataSetChanged()
}

class ViewHolder(view: View) : RecyclerView.ViewHolder(view) {
val textView: TextView = view.findViewById(R.id.textView)
}

override fun onCreateViewHolder(viewGroup: ViewGroup, viewType: Int): ViewHolder {
val view = LayoutInflater.from(viewGroup.context)
.inflate(R.layout.text_row_item, viewGroup, false)

return ViewHolder(view)
}

override fun onBindViewHolder(viewHolder: ViewHolder, position: Int) {
viewHolder.textView.text = items[position]
viewHolder.itemView.setOnClickListener { onItemClick(position) }
}

override fun getItemCount() = items.size
}

Зачем нужен вьюхолдер?

Цель RecyclerView - переиспользовать вьюхи списка, а не грузить сразу все. Для этого, проверяется, возможно ли взять уже существующую, или нужно создавать новую. Если получилось взять существующую - то в ней лежит объект viewHolder, через который можно обратиться к элементам переиспользуемой вьюхи, которые мы собираемся заполнять новыми данными. т.е. нет необходимости вызывать метод findViewById, чтобы получить доступ к вьюхам элемента списка.

Хоть у нас и есть доступ к view элемента в методе onCreateViewHolder, устанавливать там onClickListener нельзя, потому что задача viewHolder-a - это только держать ссылки на вьюхи элементов. Изучите документацию
Еще одна причина, почему привязка onClick должна быть в onBindViewHolder - это то, что viewHolder-ы можно переиспользовать между несколькими recyclerView, например для составных списков (вертикальный список из горизонтальных списков). Будет создано несколько recyclerView, и, если они будут объединены в один RecycledViewPool то они смогут обмениваться viewHolder-ами, именно поэтому viewHolder не должен привязываться к конкретному объекту адаптеру, который его создал, потому что потом его может использовать другой адаптер. И именно в методе onBindViewHolder есть гарантия, что переданный viewHolder относится к нашим данным.

Наконец, создадим наш адаптер, проинициализируем элементами с лямбдой и привяжем к recyclerView:

class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)

val dataSet = listOf("aaa", "bbb", "ccc", "ddd", "fff", "jjj","aaa", "bbb", "ccc", "ddd", "fff", "jjj")
val customAdapter = CustomAdapter { onItemClick(dataSet[it]) }
customAdapter.items = dataSet

val recyclerView: RecyclerView = findViewById(R.id.recyclerView)
recyclerView.layoutManager = LinearLayoutManager(this)
recyclerView.adapter = customAdapter
}

private fun onItemClick(title: String) {
Toast.makeText(this, "tap on $title", Toast.LENGTH_SHORT).show()
}
}

Заключение

  • передача элементов в адаптер должна быть не через конструктор, а через изменяемую переменную
  • в адаптере не должно содержаться никакой логики, только реализация привязки данных
  • задача viewHolder-а - держать ссылки на вьюхи элемента списка
  • установка onClick-лямбды должна быть в onBindViewHolder