Вибір елемента в ListView

У попередніх темах ми розглядали, як завантажувати дані в ListView, зв'язувати його з джерелом даних. Але крім простого виведення списку елементів, ListView дозволяє вибирати елемент і обробляти його вибір. Розглянемо, як це зробити. Ось розмітка в файлі activity_main.xml:

<?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">
 
    <TextView
        android:id="@+id/selection"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:textSize="22sp"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent" />
    
    <ListView
        android:id="@+id/countriesList"
        android:layout_width="0dp"
        android:layout_height="0dp"
        app:layout_constraintTop_toBottomOf="@+id/selection"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent">
    </ListView>
 
</androidx.constraintlayout.widget.ConstraintLayout>

Тепер зв'яжемо список ListView з джерелом даних і додамо слухача для обробки натискання на елемент списку:

package com.example.listapp;
 
import androidx.appcompat.app.AppCompatActivity;
 
import android.os.Bundle;
import android.view.View;
import android.widget.AdapterView;
import android.widget.ArrayAdapter;
import android.widget.ListView;
import android.widget.TextView;
 
public class MainActivity extends AppCompatActivity {
 
    String[] countries = { "Бразилія", "Аргентина", "Колумбія", "Чилі", "Уругвай"};
    
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
 
        // отримуємо елемент TextView
        TextView selection = findViewById(R.id.selection);
        // отримуємо елемент ListView
        ListView countriesList = findViewById(R.id.countriesList);
        // створюємо адаптер
        ArrayAdapter<String> adapter = new ArrayAdapter(this,
                android.R.layout.simple_list_item_1, countries);
        // встановлюємо для списку адаптер
        countriesList.setAdapter(adapter);
        // додаємо слухача для списку
        countriesList.setOnItemClickListener(new AdapterView.OnItemClickListener(){
            @Override
            public void onItemClick(AdapterView<?> parent, View v, int position, long id)
            {
                // за позицією отримуємо вибраний елемент
                String selectedItem = countries[position];
                // встановлюємо текст елемента TextView
                selection.setText(selectedItem);
            }
        });
    }
}

Отже, метод setAdapter зв'язує елемент ListView з визначеним адаптером. Далі, для обробки вибору елемента списку, встановлюється слухач OnItemClickListener. Цей слухач має один метод onItemClick, через параметри якого ми можемо отримати вибраний елемент і супутні дані. Так, він приймає наступні параметри:

parent: натиснутий елемент AdapterView (в ролі якого в даному випадку виступає наш елемент ListView)
view: натиснутий віджет всередині AdapterView
position: індекс натискання віджету всередині AdapterView
id: ідентифікатор рядка натиснутого елемента

Використовуючи ці параметри, ми можемо різними способами отримати вибраний елемент.

Наприклад, у цьому випадку, отримуючи індекс натиснутого віджету, який відповідає індексу елемента в масиві рядків, ми можемо встановити відповідний елемент у масиві рядків і таким чином отримати його текст:

countriesList.setOnItemClickListener(new AdapterView.OnItemClickListener(){
    @Override
    public void onItemClick(AdapterView<?> parent, View v, int position, long id)
    {
        // за позицією отримуємо вибраний елемент
        String selectedItem = countries[position];
        // встановлення тексту елемента TextView
        selection.setText(selectedItem);
    }
});

Також ми можемо отримати виділений елемент з AdapterView, який передається як перший параметр - AdapterView<?> parent. У цьому випадку ми знаємо, що кожен елемент у AdapterView фактично представляє рядок або об'єкт String, тому в цьому випадку можна отримати виділений елемент таким чином:

countriesList.setOnItemClickListener(new AdapterView.OnItemClickListener(){
    @Override
    public void onItemClick(AdapterView<?> parent, View v, int position, long id)
    {
        // отримуємо вибраний елемент
        String selectedItem = (String)parent.getItemAtPosition(position);
        // встановлення тексту елемента TextView
        selection.setText(selectedItem);
    }
});

Метод getItemAtPosition повертає виділений елемент за індексом. Це може бути корисно, якщо ми використовуємо як джерело даних не масив рядків, створений у коді Java, а, наприклад, ресурс <string-array>, заданий у файлі xml.

По-третє, ми можемо використати виділений елемент, який передається як другий параметр - View v. У цьому випадку адаптер використовує в якості типу розмітки ресурс - android.R.layout.simple_list_item_1, а це означає, що виділений елемент є елементом TextView, в якому виводиться цей текст. Тому в цьому випадку ми також могли б отримати виділений елемент так:

countriesList.setOnItemClickListener(new AdapterView.OnItemClickListener(){
    @Override
    public void onItemClick(AdapterView<?> parent, View v, int position, long id)
    {
        // отримуємо вибраний елемент
        TextView textView = (TextView) v;
        String selectedItem = (String)textView.getText();
        // встановлення тексту елемента TextView
        selection.setText(selectedItem);
        // або так
        // selection.setText(textView.getText());
    }
});

Множинний вибір у списку

Іноді потрібно вибрати не один елемент, як за замовчуванням, а кілька. Для цього, по-перше, у розмітці списку треба встановити атрибут android:choiceMode="multipleChoice":

<?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">

    <TextView
        android:id="@+id/selection"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:textSize="22sp"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent" />
        
    <ListView
        android:id="@+id/countriesList"
        android:choiceMode="multipleChoice"
        android:layout_width="0dp"
        android:layout_height="0dp"
        app:layout_constraintTop_toBottomOf="@+id/selection"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent">
    </ListView>

</androidx.constraintlayout.widget.ConstraintLayout>

Тепер визначимо в коді MainActivity обробку вибору елементів списку:

package com.example.listapp;

import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import android.util.SparseBooleanArray;
import android.view.View;
import android.widget.AdapterView;
import android.widget.ArrayAdapter;
import android.widget.ListView;
import android.widget.TextView;

public class MainActivity extends AppCompatActivity {

    String[] countries = { "Бразилія", "Аргентина", "Колумбія", "Чилі", "Уругвай"};
    
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // отримуємо елемент TextView
        TextView selection = findViewById(R.id.selection);
        // отримуємо елемент ListView
        ListView countriesList = findViewById(R.id.countriesList);
        // створюємо адаптер
        ArrayAdapter<String> adapter = new ArrayAdapter(this,
                android.R.layout.simple_list_item_multiple_choice, countries);
        // встановлюємо для списку адаптер
        countriesList.setAdapter(adapter);
        // додаємо для списку слухач
        countriesList.setOnItemClickListener(new AdapterView.OnItemClickListener(){
            @Override
            public void onItemClick(AdapterView<?> parent, View v, int position, long id)
            {
                SparseBooleanArray selected = countriesList.getCheckedItemPositions();

                String selectedItems = "";
                for (int i = 0; i < countries.length; i++) {
                    if (selected.get(i))
                        selectedItems += countries[i] + ",";
                }
                // встановлення тексту елемента TextView
                selection.setText("Вибрано: " + selectedItems);
            }
        });
    }
}

Ресурс android.R.layout.simple_list_item_multiple_choice представляє стандартну розмітку, надану фреймвокем, для створення списку з множинним вибором.

При виборі елементів ми отримуємо всі вибрані позиції в об'єкті SparseBooleanArray, потім проходимо по всьому масиву, і якщо позиція елемента в масиві є в SparseBooleanArray, тобто вона відмічена, то додаємо відмічений елемент у рядок.

Edit this page on GitHub

Lesson3Ресурс string-array і ListView

Lesson3Додавання та видалення в ArrayAdapter і ListView