【Android】ListViewをScrollViewの中で折りたたまずに表示する方法

この記事では、Androidアプリ開発においてListViewをScrollViewの中に折りたたまず（縮まず）にそのまま表示する方法を、実際のコード例とともに解説します。

なぜListViewはScrollView内で折りたたまれるのか？

ScrollViewとListViewは、どちらも独自のスクロール機能を持つビューです。そのため、ScrollViewの中にListViewをそのまま配置すると高さの計測が競合し、ListViewが最初の1行分しか表示されない「折りたたまれた」状態になってしまいます。

この問題を回避するには、アダプターに含まれるすべてのアイテムの高さを事前に計算し、その合計値を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:app="https://schemas.android.com/apk/res-auto"
   xmlns:tools="https://schemas.android.com/tools"
   android:layout_width="match_parent"
   android:layout_height="match_parent"
   tools:context=".MainActivity">
   <LinearLayout
      android:layout_width="match_parent"
      android:layout_height="match_parent"
      android:orientation ="vertical" >
      <TextView
         android:layout_width="wrap_content"
         android:layout_height="wrap_content"
         android:layout_marginTop="19dp"
         android:text="hello_world" />
      <ListView
         android:id="@+id/listView"
         android:layout_width="fill_parent"
         android:layout_height="fill_parent" />
   </LinearLayout>
</ScrollView>

ステップ3：MainActivity.java を実装する

src/MainActivity.javaに以下のコードを追加します。ポイントは、アダプターをセットした後にHelper.getListViewSize(myList)を呼び出している点です。

package com.example.sample;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.ArrayAdapter;
import android.widget.ListView;
public class MainActivity extends AppCompatActivity {
   private String listview_array[]={ "ONE", "TWO", "THREE", "FOUR", "FIVE", "SIX", "SEVEN", "EIGHT", "NINE", "TEN" };
   ListView myList;
   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);
      myList=(ListView) findViewById(R.id.listView);
      myList.setAdapter(new ArrayAdapter<String>(this,android.R.layout.simple_list_item_1, listview_array));
      Helper.getListViewSize(myList);
   }
}

※新しいプロジェクトではサポートライブラリの代わりにAndroidX（androidx.appcompat.app.AppCompatActivity）を使用してください。

ステップ4：Helperクラスを作成する

src/Helper.javaを作成し、以下のコードを追加します。このクラスが本記事の核心部分です。各アイテムの高さをmeasure()で計測し、区切り線（divider）の高さも加味した合計値をListViewの高さとして設定しています。

package com.example.sample;
import android.util.Log;
import android.view.View;
import android.view.ViewGroup;
import android.widget.ListAdapter;
import android.widget.ListView;
public class Helper {
   public static void getListViewSize(ListView myListView) {
      ListAdapter myListAdapter=myListView.getAdapter();
      if (myListAdapter==null) {
         //do nothing return null
         return;
      }
      //set listAdapter in loop for getting final size
      int totalHeight=0;
      for (int size=0; size < myListAdapter.getCount(); size++) {
         View listItem=myListAdapter.getView(size, null, myListView);
         listItem.measure(0, 0);
         totalHeight+=listItem.getMeasuredHeight();
      }
      //setting listview item in adapter
      ViewGroup.LayoutParams params=myListView.getLayoutParams();
      params.height=totalHeight + (myListView.getDividerHeight() * (myListAdapter.getCount() - 1));
      myListView.setLayoutParams(params);
      // print height of adapter on log
      Log.i("height of listItem:", String.valueOf(totalHeight));
   }
}

ステップ5：AndroidManifest.xml を編集する

app/manifests/AndroidManifest.xmlに以下のコードを記述します。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="com.example.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端末をPCに接続した状態で、Android Studioからプロジェクトのアクティビティファイルを開き、ツールバーのRunアイコンをクリックします。接続したモバイルデバイスを選択すると、端末に以下のような画面が表示されます。

まとめ

ScrollViewの中にListViewを配置すると高さが正しく計測されず、リストが折りたたまれてしまう問題は、全アイテムの高さを計算してListViewのLayoutParamsに反映させることで解決できます。ただし、アイテム数が多い場合はすべてのアイテムを描画するコストが発生するため、RecyclerViewやNestedScrollViewの活用もあわせて検討するとよいでしょう。