AndroidでカスタムListViewを作成する方法｜CustomAdapterを使った実装手順を解説

リストビューの実装例に入る前に、まずリストビュー（ListView）について簡単におさらいしておきましょう。リストビューとは、ArrayListやリスト、データベースなどから取得したアイテムのコレクションを一覧表示するUI部品です。多くの場合、アイテムは縦方向に並んで表示され、ユーザーは上下にスクロールしながら、任意の項目をタップして操作できます。

カスタムListViewとは？

カスタムListViewは、CustomAdapter（カスタムアダプター）を基盤として動作します。カスタムアダプターを利用することで、単純な文字列だけでなく、独自に定義したオブジェクトをリストに渡せるようになるのが大きな特徴です。本記事では、科目名・リンクURL・画像URLを持つ「SubjectData」というデータクラスを作成し、それをリストビューに表示する方法を順番に解説していきます。

カスタムListViewの実装手順

ステップ1：新規プロジェクトを作成する

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

ステップ2：activity_main.xmlにレイアウトを記述する

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

<?xml version = "1.0" encoding = "utf-8"?>
<android.support.constraint.ConstraintLayout
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">
<LinearLayout
   android:layout_width = "match_parent"
   android:layout_height = "match_parent"
   android:orientation = "vertical">
   <ListView
      android:id = "@+id/list"
      android:layout_width = "wrap_content"
      android:layout_height = "match_parent"
      android:divider = "#000"
      android:dividerHeight = "1dp"
      android:footerDividersEnabled = "false"
      android:headerDividersEnabled = "false"/>
</LinearLayout>
</android.support.constraint.ConstraintLayout>

上記のactivity_main.xmlでは、リストビューを1つ宣言し、あわせて区切り線（ディバイダー）の設定も行っています。該当する部分を抜粋すると、次の通りです。

<ListView
   android:id = "@+id/list"
   android:layout_width = "wrap_content"
   android:layout_height = "match_parent"
   android:divider = "#000"
   android:dividerHeight = "1dp"
   android:footerDividersEnabled = "false"
   android:headerDividersEnabled = "false"
/>

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

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

import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.widget.ListView;
import java.util.ArrayList;
public class MainActivity extends AppCompatActivity {
   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);
      final ListView list = findViewById(R.id.list);
      ArrayList<SubjectData> arrayList = new ArrayList<SubjectData>();
      arrayList.add(new SubjectData("JAVA", "https://www.tutorialspoint.com/java/",             "https://www.tutorialspoint.com/java/images/java-mini-logo.jpg"));
      arrayList.add(new SubjectData("Python", "https://www.tutorialspoint.com/python/", "https://www.tutorialspoint.com/python/images/python-mini.jpg"));
      arrayList.add(new SubjectData("Javascript", "https://www.tutorialspoint.com/javascript/", "https://www.tutorialspoint.com/javascript/images/javascript-mini-logo.jpg"));
      arrayList.add(new SubjectData("Cprogramming", "https://www.tutorialspoint.com/cprogramming/", "https://www.tutorialspoint.com/cprogramming/images/c-mini-logo.jpg"));
      arrayList.add(new SubjectData("Cplusplus", "https://www.tutorialspoint.com/cplusplus/", "https://www.tutorialspoint.com/cplusplus/images/cpp-mini-logo.jpg"));
      arrayList.add(new SubjectData("Android", "https://www.tutorialspoint.com/android/", "https://www.tutorialspoint.com/android/images/android-mini-logo.jpg"));
      CustomAdapter customAdapter = new CustomAdapter(this, arrayList);
      list.setAdapter(customAdapter);
   }
}

MainActivityでは、以下のようにCustomAdapterを生成し、SubjectDataのリストを渡しています。これにより、独自のデータをリストビューに反映できるようになります。

CustomAdapter customAdapter = new CustomAdapter(this, arrayList);
list.setAdapter(customAdapter);

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

src/CustomAdapter.java を新規作成し、以下のコードを追加します。このクラスが、カスタムListViewの中核となる部分です。

import android.content.Context;
import android.database.DataSetObserver;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.ImageView;
import android.widget.ListAdapter;
import android.widget.TextView;
import com.squareup.picasso.Picasso;
import java.util.ArrayList;
class CustomAdapter implements ListAdapter {
   ArrayList<SubjectData> arrayList;
   Context context;
   public CustomAdapter(Context context, ArrayList<SubjectData> arrayList) {
      this.arrayList=arrayList;
      this.context=context;
   }
   @Override
   public boolean areAllItemsEnabled() {
      return false;
   }
   @Override
   public boolean isEnabled(int position) {
      return true;
   }
   @Override
   public void registerDataSetObserver(DataSetObserver observer) {
   }
   @Override
   public void unregisterDataSetObserver(DataSetObserver observer) {
   }
   @Override
   public int getCount() {
      return arrayList.size();
   }
   @Override
   public Object getItem(int position) {
      return position;
   }
   @Override
   public long getItemId(int position) {
      return position;
   }
   @Override
   public boolean hasStableIds() {
      return false;
   }
   @Override
   public View getView(int position, View convertView, ViewGroup parent) {
      SubjectData subjectData=arrayList.get(position);
      if(convertView==null) {
         LayoutInflater layoutInflater = LayoutInflater.from(context);
         convertView=layoutInflater.inflate(R.layout.list_row, null);
         convertView.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
            }
         });
         TextView tittle=convertView.findViewById(R.id.title);
         ImageView imag=convertView.findViewById(R.id.list_image);
         tittle.setText(subjectData.SubjectName);
         Picasso.with(context)
         .load(subjectData.Image)
         .into(imag);
      }
      return convertView;
   }
   @Override
   public int getItemViewType(int position) {
      return position;
   }
   @Override
   public int getViewTypeCount() {
      return arrayList.size();
   }
   @Override
   public boolean isEmpty() {
      return false;
   }
}

ステップ5：SubjectDataクラスを作成する

src/SubjectData.java を新規作成し、以下のコードを追加します。このクラスは、リストに表示する1件分のデータ（科目名・リンク・画像URL）を保持するモデルクラスです。

class SubjectData {
   String SubjectName;
   String Link;
   String Image;
   public SubjectData(String subjectName, String link, String image) {
      this.SubjectName = subjectName;
      this.Link = link;
      this.Image = image;
   }
}

ステップ6：Picassoでネットワーク上の画像を表示する

CustomAdapterクラス内では、インターネット上の画像をリストに表示しています。ネットワーク上の画像を読み込んでImageViewにセットするために、画像読み込みライブラリ「Picasso」を使用しているのがポイントです。

Picasso.with(context)
.load(subjectData.Image)
.into(imag);

ステップ7：build.gradleにPicassoライブラリを追加する

Picassoライブラリを利用するには、build.gradle の dependencies にライブラリの依存関係を追記する必要があります。以下のように設定しましょう。

apply plugin: 'com.android.application'
android {
   compileSdkVersion 28
   defaultConfig {
      applicationId "com.example.andy.myapplication"
      minSdkVersion 15
      targetSdkVersion 28
      versionCode 1
      versionName "1.0"
      testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
   }  
   buildTypes {
      release {
         minifyEnabled false
         proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
      }
   }
}
dependencies {
   implementation fileTree(dir: 'libs', include: ['*.jar'])
   implementation 'com.android.support:appcompat-v7:28.0.0'
   implementation 'com.android.support.constraint:constraint-layout:1.1.3'
   testImplementation 'junit:junit:4.12'
   implementation 'com.squareup.picasso:picasso:2.5.1'
   androidTestImplementation 'com.android.support.test:runner:1.0.2'
   androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'
}

ステップ8：AndroidManifest.xmlにインターネット権限を追加する

インターネット上の情報へアクセスするためには、AndroidManifest.xml にインターネット権限（INTERNETパーミッション）を宣言しておく必要があります。

<?xml version = "1.0" encoding = "utf-8"?>
<manifest xmlns:android = "https://schemas.android.com/apk/res/android"
   package = "com.example.andy.myapplication">
<uses-permission android:name = "android.permission.INTERNET"/>
   <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（実行） アイコンをクリックします。接続済みのモバイルデバイスを選択すれば、端末側の画面にアプリの初期画面が表示されます。

補足：RecyclerViewとの使い分けについて

近年のAndroid開発では、ListViewよりも柔軟性とスクロール性能に優れたRecyclerViewの採用が推奨される傾向にあります。その一方で、ListViewは構造がシンプルで理解しやすいため、学習用途や小規模なリスト表示には今なお十分活躍する部品です。まずは本記事のコードを通じて、カスタムアダプターの仕組みをしっかり把握しておくと、後々RecyclerViewへの移行もスムーズになりますよ。