【Android開発】ListViewのクリックイベントを処理する方法を徹底解説

AndroidのListViewでクリックイベントを処理する方法

この記事では、AndroidアプリのListViewでアイテムがクリックされたときのイベントを処理する方法を、実際のコード例とともにステップごとに解説します。ListViewはリスト形式のデータを表示する際に頻繁に使われるUIコンポーネントであり、ユーザーがアイテムをタップした際の動きを実装できるようになると、アプリの使い勝手が大きく向上します。

ステップ1：新規プロジェクトの作成

Android Studioを開き、File → New Projectを選択して新しいプロジェクトを作成します。必要な項目をすべて入力してプロジェクトのセットアップを完了させてください。

ステップ2：レイアウトファイル（activity_main.xml）の編集

次に、res/layout/activity_main.xmlに以下のコードを追加します。このレイアウトには、質問文を表示するTextViewと、サッカー選手のリストを表示するListViewが配置されています。

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout
    xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:tools="https://schemas.android.com/tools"
    android:id="@+id/rl"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:padding="10dp"
    tools:context=".MainActivity">
    <TextView
        android:id="@+id/textview"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:textStyle="italic"
        android:textColor="#5f65ff"
        android:padding="5dp"
        android:text="Choose is the best football player?"/>
    <ListView
        android:id="@+id/listview"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_below="@id/textview" />
</RelativeLayout>

ステップ3：MainActivity.javaにクリックイベント処理を追加

続いて、src/MainActivity.javaに以下のコードを記述します。ポイントはsetOnItemClickListener()メソッドです。このメソッドを使うことで、ListViewの各アイテムがクリック（タップ）されたときにonItemClick()が呼び出され、クリックされたアイテムの位置（position）から選択された項目を取得できます。

import android.support.v7.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;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;
public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        ListView listView = (ListView) findViewById(R.id.listview);
        final TextView textView = (TextView) findViewById(R.id.textview);
        String[] players = new String[] {"CR7", "Messi", "Hazard", "Neymar"};
        List<String> Players_list = new ArrayList<String>(Arrays.asList(players));
        ArrayAdapter<String> arrayAdapter = new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, Players_list);
        listView.setAdapter(arrayAdapter);
        listView.setOnItemClickListener(new AdapterView.OnItemClickListener() {
            @Override
            public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
                String selectedItem = (String) parent.getItemAtPosition(position);
                textView.setText("The best football player is : " + selectedItem);
            }
        });
    }
}

このコードの処理の流れは以下の通りです。

1. 選手名の配列（CR7、Messi、Hazard、Neymar）を作成し、Listに変換します。
2. ArrayAdapterを使ってデータをListViewに紐付けます。
3. setOnItemClickListener()でクリックリスナーを登録し、タップされたアイテムの文字列を取得してTextViewに表示します。

ステップ4：AndroidManifest.xmlの確認

最後に、androidManifest.xmlが以下のようになっていることを確認してください。通常、新規プロジェクト作成時には自動的に生成されています。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="app.com.sample">
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

アプリの実行と動作確認

それでは、アプリを実行してみましょう。Android端末をパソコンにUSB接続していることを前提とします。Android Studioでプロジェクト内のアクティビティファイルを開き、ツールバーのRunアイコンをクリックしてください。実行デバイスとして自分のモバイル端末を選択すると、端末の画面にアプリが起動します。

アプリが起動したら、リストから任意の選手名をタップしてみてください。画面上部のTextViewに「The best football player is : （選択した選手名）」と表示されれば、クリックイベントが正しく処理されています。

まとめ

ListViewのクリックイベント処理は、setOnItemClickListener()とonItemClick()コールバックを使うだけで簡単に実装できます。クリックされたアイテムはgetItemAtPosition(position)で取得できるため、画面遷移や詳細表示など、さまざまな処理に応用できます。なお、近年のAndroid開発ではRecyclerViewの利用が推奨されるケースも多いため、ListViewの基本を理解したら、RecyclerViewでの実装方法もあわせて学んでおくとさらに良いでしょう。