【Kotlin】AndroidでListViewをScrollView内に潰れずに表示する方法

この記事では、Kotlinを使ったAndroidアプリ開発において、ListViewをScrollViewの中に配置しても高さが潰れないように表示する方法を解説します。

通常、ListViewをScrollViewの内部に直接配置すると、リストが1行分しか表示されない「潰れた」状態になってしまいます。これは両者とも縦方向のスクロール機能を持つため、測定が正しく行われないことが原因です。この問題を回避するには、ListViewの全アイテムの高さを事前に計算し、ListView自体の高さを動的に設定するアプローチが有効です。

実装手順

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

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

ステップ2：レイアウトファイルの編集

res/layout/activity_main.xml に以下のコードを記述します。

コード例

<?xml version="1.0" encoding="utf-8"?>
<ScrollView xmlns:android="https://schemas.android.com/apk/res/android"
xmlns:tools="https://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:padding="4dp"
    tools:context=".MainActivity">
<LinearLayout
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">
<ListView
    android:id="@+id/listView"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent" />
</LinearLayout>
</ScrollView>

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

src/MainActivity.kt に以下のコードを追加します。

import android.os.Bundle
import android.widget.ArrayAdapter
import android.widget.ListView
import androidx.appcompat.app.AppCompatActivity
class MainActivity : AppCompatActivity() {
    private val listViewArray = arrayOf(
        "ONE", "TWO", "THREE", "FOUR", "FIVE", "SIX", "SEVEN", "EIGHT", "NINE",
        "TEN", "Eleven", "Twelve", "Thirteen", "Fourteen", "Fifteen", "Sixteen"
    )
    lateinit var list: ListView
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        title = "KotlinApp";
        list = findViewById(R.id.listView)
        list.adapter = ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, listViewArray)
        ListHelper.getListViewSize(list)
    }
}

ステップ4：ListHelperクラスの作成

新しいKotlinクラス「ListHelper.kt」を作成し、以下のコードを記述します。このクラスが、ListViewの各アイテムの高さを測定して合計値を算出し、ListView全体の高さとして設定する重要な役割を担います。

import android.util.Log
import android.widget.ListAdapter
import android.widget.ListView
object ListHelper {
    fun getListViewSize(myListView: ListView) {
        val myListAdapter: ListAdapter = myListView.adapter
        ?: //do nothing return null
        return
        //set listAdapter in loop for getting final size
        var totalHeight = 0
        for (size in 0 until myListAdapter.count) {
            val listItem = myListAdapter.getView(size, null, myListView)
            listItem.measure(0, 0)
            totalHeight += listItem.measuredHeight
        }
        //setting listView item in adapter
        val params = myListView.layoutParams
        params.height =
        totalHeight + myListView.dividerHeight * (myListAdapter.count - 1)
        myListView.layoutParams = params
        // print height of adapter on log
        Log.i("height of listItem:", totalHeight.toString())
    }
}

ステップ5：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の全アイテムが潰れることなく、ScrollView内で正しく表示されていることを確認できます。