ListView і ArrayAdapter

Android представляє широку палітру елементів, які представляють списки. Усі вони є спадкоємцями класу android.widget.AdapterView. Це такі віджети як ListView, GridView, Spinner. Вони можуть виступати контейнерами для інших елементів керування.

При роботі зі списками ми маємо справу з трьома компонентами:

  1. Візуальний елемент або віджет, який на екрані представляє список, наприклад:
    • ListView
    • GridView

    Ці віджети відображають дані.
  2. Джерело даних — масив, об'єкт ArrayList, база даних тощо, в якому зберігаються самі відображувані дані.
  3. Адаптер — спеціальний компонент, який пов'язує джерело даних з віджетом списку.

Одним із найпростіших і поширених елементів списку є віджет ListView. Розглянемо зв'язок елемента ListView з джерелом даних за допомогою одного з таких адаптерів — класу ArrayAdapter.

ArrayAdapter — це найпростіший адаптер, який пов'язує масив даних з набором елементів TextView, з яких, наприклад, може складатися ListView.

Тобто в даному випадку джерелом даних виступає масив об'єктів.

ArrayAdapter викликає у кожного об'єкта метод toString() для приведення до рядкового вигляду і отриману строку встановлює в елемент TextView.

Подивимося на приклад. Отже, розмітка додатку може виглядати так:

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
     
    <ListView
        android:id="@+id/countriesList"
        android:layout_width="0dp"
        android:layout_height="0dp"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent">
    </ListView>
 
</androidx.constraintlayout.widget.ConstraintLayout>

Тут також визначений елемент ListView, який буде відображати список об'єктів. Тепер перейдемо до коду activity і зв'яжемо ListView через ArrayAdapter з деякими даними:

package com.example.listapp;

import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.ArrayAdapter;
import android.widget.ListView;

public class MainActivity extends AppCompatActivity {

    // Набір даних, які зв'яжемо зі списком
    String[] countries = { "Бразилія", "Аргентина", "Колумбія", "Чилі", "Уругвай"};

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // Отримуємо елемент ListView
        ListView countriesList = findViewById(R.id.countriesList);

        // Створюємо адаптер
        ArrayAdapter<String> adapter = new ArrayAdapter(this,
                android.R.layout.simple_list_item_1, countries);

        // Встановлюємо адаптер для списку
        countriesList.setAdapter(adapter);
    }
}

Тут спочатку отримуємо за id елемент ListView і потім створюємо для нього адаптер.

Пояснення конструктора ArrayAdapter:

  • this: поточний об'єкт activity.
  • android.R.layout.simple_list_item_1: файл розмітки списку, який фреймворк надає за замовчуванням. Він знаходиться в папці Android SDK за шляхом platforms/[android-номер_версії]/data/res/layout. Якщо нас не влаштовує стандартна розмітка списку, ми можемо створити свою і потім у коді змінити id на id потрібної нам розмітки.
  • countries: масив даних. Тут не обов'язково вказувати саме масив, це може бути список ArrayList<T>.

В кінці необхідно встановити для ListView адаптер за допомогою методу setAdapter(). У підсумку ми отримаємо таке відображення:

Edit this page on GitHub