How to create a multilevel ListView in an Android app?

This example demonstrates how do I create a multilevel listView in android.

Step 1 − Create a new project in Android Studio, go to File ⇒ New Project and fill all required details to create a new project.

Step 2 − Add the following code to res/layout/activity_main.xml.

Step 3 − Add the following code to src/MainActivity.java

import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.ExpandableListAdapter;
import android.widget.ExpandableListView;
import android.widget.Toast;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
public class MainActivity extends AppCompatActivity {
   ExpandableListView expandableListView;
   ExpandableListAdapter expandableListAdapter;
   ListexpandableListTitle;
   HashMap> expandableListDetail;
   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);
      expandableListView = findViewById(R.id.expendableList);
      expandableListDetail = ExpandableListData.getData();
      expandableListTitle = new ArrayList(expandableListDetail.keySet());
      expandableListAdapter = new CustomExpandableListAdapter(this, expandableListTitle, expandableListDetail);
      expandableListView.setAdapter(expandableListAdapter);
      expandableListView.setOnGroupExpandListener(new ExpandableListView.OnGroupExpandListener() {
         @Override
         public void onGroupExpand(int groupPosition) {
         Toast.makeText(getApplicationContext(), expandableListTitle.get(groupPosition)
            + " List Expanded.", Toast.LENGTH_SHORT).show();
      }
   });
   expandableListView.setOnGroupCollapseListener(new ExpandableListView.OnGroupCollapseListener() {
      @Override
      public void onGroupCollapse(int groupPosition) {
         Toast.makeText(getApplicationContext(), expandableListTitle.get(groupPosition) + " List Collapsed.",
            Toast.LENGTH_SHORT).show();
      }
   });
   expandableListView.setOnChildClickListener(new ExpandableListView.OnChildClickListener() {
      @Override
      public boolean onChildClick(ExpandableListView parent, View v, int groupPosition, int childPosition, long id) {
            Toast.makeText( getApplicationContext(), expandableListTitle.get(groupPosition) + "
               -> " + expandableListDetail.get( expandableListTitle.get(groupPosition)).get( childPosition), Toast.LENGTH_SHORT ).show();
            return false;
         }
      });
   }
}

Step 4 − Create a java class (ExpandableListData.java) and the following code

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
class ExpandableListData {
   static HashMap> getData() {
      HashMap> expandableListDetail = new HashMap();
      List myFavCricketPlayers = new ArrayList();
      myFavCricketPlayers.add("MS.Dhoni");
      myFavCricketPlayers.add("Sehwag");
      myFavCricketPlayers.add("Shane Watson");
      myFavCricketPlayers.add("Ricky Ponting");
      myFavCricketPlayers.add("Shahid Afridi");
      List myFavFootballPlayers = new ArrayList();
      myFavFootballPlayers.add("Cristiano Ronaldo");
      myFavFootballPlayers.add("Lionel Messi");
      myFavFootballPlayers.add("Gareth Bale");
      myFavFootballPlayers.add("Neymar JR");
      myFavFootballPlayers.add("David de Gea");
      List myFavTennisPlayers = new ArrayList();
      myFavTennisPlayers.add("Roger Federer");
      myFavTennisPlayers.add("Rafael Nadal");
      myFavTennisPlayers.add("Andy Murray");
      myFavTennisPlayers.add("Novak Jokovic");
      myFavTennisPlayers.add("Sania Mirza");
      expandableListDetail.put("CRICKET PLAYERS", myFavCricketPlayers);
      expandableListDetail.put("FOOTBALL PLAYERS", myFavFootballPlayers);
      expandableListDetail.put("TENNIS PLAYERS", myFavTennisPlayers);
      return expandableListDetail;
   }
}

Step 5 − Create a java class (CustomExpandableListAdapter.java) and the following code

package app.com.sample;
import android.content.Context;
import android.graphics.Typeface;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.BaseExpandableListAdapter;
import android.widget.TextView;
import java.util.HashMap;
import java.util.List;
import java.util.Objects;
class CustomExpandableListAdapter extends BaseExpandableListAdapter {
   private Context context;
   private List expandableListTitle;
   private HashMap> expandableListDetail;
   CustomExpandableListAdapter(Context context, List expandableListTitle, HashMap> expandableListDetail) {
      this.context = context;
      this.expandableListTitle = expandableListTitle;
      this.expandableListDetail = expandableListDetail;
   }
   @Override
   public Object getChild(int listPosition, int expandedListPosition) {
      return
      Objects.requireNonNull(this.expandableListDetail.get(this.expandableListTitle.get(list Position))).get(expandedListPosition);
   }
   @Override
   public long getChildId(int listPosition, int expandedListPosition) {
      return expandedListPosition;
   }
   @Override
   public View getChildView(int listPosition, final int expandedListPosition, boolean isLastChild, View convertView, ViewGroup parent) {
      final String expandedListText = (String) getChild(listPosition, expandedListPosition);
      if (convertView == null) {
         LayoutInflater layoutInflater = (LayoutInflater) this.context.getSystemService(Context.LAYOUT_INFLATER_SERVICE);
         convertView = Objects.requireNonNull(layoutInflater).inflate(R.layout.list_row, null);
      }
      TextView textView = convertView.findViewById(R.id.listTitle);
      textView.setText(expandedListText);
      return convertView;
   }
   @Override
   public int getChildrenCount(int listPosition) {
      return
      this.expandableListDetail.get(this.expandableListTitle.get(listPosition)).size();
   }
   @Override
   public Object getGroup(int listPosition) {
      return this.expandableListTitle.get(listPosition);
   }
   @Override
   public int getGroupCount() {
      return this.expandableListTitle.size();
   }
   @Override
   public long getGroupId(int listPosition) {
      return listPosition;
   }
   @Override
   public View getGroupView(int listPosition, boolean isExpanded, View convertView, ViewGroup parent) {
      String listTitle = (String) getGroup(listPosition);
      if (convertView == null) {
         LayoutInflater layoutInflater = (LayoutInflater) this.context. getSystemService(Context.LAYOUT_INFLATER_SERVICE);
         convertView = Objects.requireNonNull(layoutInflater).inflate(R.layout.list_row, null);
      }
      TextView listTitleTextView = convertView.findViewById(R.id.listTitle);
      listTitleTextView.setTypeface(null, Typeface.BOLD);
      listTitleTextView.setText(listTitle);
      return convertView;
   }
   @Override
   public boolean hasStableIds() {
      return false;
   }
   @Override
   public boolean isChildSelectable(int listPosition, int expandedListPosition) {
      return true;
   }
}

Step 6 − Create a layout resource file(list_row.xml) and add the following code −

Step 7 − Add the following code to androidManifest.xml

Let's try to run your application. I assume you have connected your actual Android Mobile device with your computer. To run the app from the android studio, open one of your project's activity files and click Run  icon from the toolbar. Select your mobile device as an option and then check your mobile device which will display your default screen −

Click here to download the project code.