【Kotlin入門】AndroidのListViewでクリックイベントを処理する方法を徹底解説

本記事では、Kotlinを使用してAndroidアプリのListViewでクリックイベントを処理する方法を、実際のコード例とともにステップごとにわかりやすく解説します。リスト項目がタップされたときに、選択された項目の情報を取得して表示するシンプルなサンプルアプリを作成していきましょう。

完成イメージ

サッカー選手の名前一覧をListViewで表示し、任意の選手をタップすると、「最も優れたサッカー選手は〇〇です」というメッセージをTextViewに表示するアプリです。

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

まず、Android Studioで新しいプロジェクトを作成します。メニューから File → New Project を選択し、必要な項目をすべて入力してプロジェクトを作成してください。

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

次に、res/layout/activity_main.xml に以下のコードを追加します。

<?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:padding="5dp"
        android:text="Choose is the best football player?"
        android:textColor="@android:color/holo_purple"
        android:textStyle="italic|bold" />

    <ListView
        android:id="@+id/listView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_below="@id/textView" />

</RelativeLayout>

このレイアウトでは、質問文を表示するTextViewと、その下に配置されるListViewを定義しています。

ステップ3：MainActivity.ktの実装

続いて、src/MainActivity.kt に以下のコードを記述します。

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

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        title = "KotlinApp"

        val listView: ListView = findViewById(R.id.listView)
        val textView: TextView = findViewById(R.id.textView)

        val players = arrayOf(
            "Cristiano Ronaldo", "Messi", "Pele",
            "Ronaldinho", "Maradona", "Neymar"
        )
        val playerList = ArrayList(listOf(*players))

        val arrayAdapter = ArrayAdapter(this, android.R.layout.simple_list_item_1, playerList)
        listView.adapter = arrayAdapter

        // ListViewのクリックイベントを処理
        listView.setOnItemClickListener { parent, _, position, _ ->
            val selectedItem = parent.getItemAtPosition(position) as String
            textView.text = "The best football player is $selectedItem"
        }
    }
}

ポイントとなるのは setOnItemClickListener の部分です。Kotlinではラムダ式を使って簡潔にクリックリスナーを記述でき、position パラメータからタップされた項目を取得し、文字列テンプレート（$selectedItem）を使ってTextViewに反映しています。

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

最後に、androidManifest.xml に以下のコードを追加します。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
    package="com.example.q11">

    <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端末をパソコンに接続していることを前提としています。

Android Studioからアプリを実行するには、プロジェクト内のアクティビティファイルを開き、ツールバーにある実行（Run）アイコンをクリックします。デバイス選択ダイアログが表示されるので、接続したモバイルデバイスを選択してください。

アプリが起動すると、選手名の一覧がListViewに表示されます。任意の選手をタップすると、上部のTextViewに「The best football player is ○○」というメッセージが表示されれば成功です。

まとめ

KotlinでListViewのクリックイベントを処理するには、setOnItemClickListener を使用します。ラムダ式のおかげでJavaよりも少ないコード量で直感的に書けるのがKotlinの魅力です。今回のサンプルをベースに、カスタムアダプターを使ったリストやRecyclerViewへの応用にもぜひ挑戦してみてください。