Bem-vindo ao Tutorial de Exemplo do Android ExpandableListView. Neste tutorial, vamos implementar um ExpandableListView, que é usado para agrupar dados de lista por categorias. É uma espécie de menu e submenus em um Android ListView.
Android ExpandableListView
O Android ExpandableListView é uma visualização que mostra itens em uma lista de dois níveis com rolagem vertical. Difere de um ListView permitindo dois níveis, que são grupos que podem ser facilmente expandidos e recolhidos ao tocar para visualizar e seus respectivos itens filhos. ExpandableListViewAdapter no Android carrega os dados nos itens associados a esta visualização. Aqui estão alguns métodos importantes usados por esta classe:
- setChildIndicator(Drawable): Isso é usado para mostrar um indicador ao lado de cada item representando o estado atual. Se o filho for o último filho de um grupo, o estado
state_last
será definido - setGroupIndicator(Drawable): Um indicador é desenhado ao lado do grupo representando seu estado, ou seja, expandido ou recolhido. Se o grupo estiver vazio, o estado
state_empty
será definido. Se o grupo estiver expandido, o estadostate_expanded
será definido - getGroupView(): Retorna a visualização do cabeçalho do grupo da lista
- getChildView() : Ele retorna a visualização para o item filho da lista
As interfaces notáveis que são implementadas por esta classe são fornecidas abaixo:
- ExpandableListView.OnChildClickListener : Isso é sobrescrito para implementar o método de retorno de chamada que é invocado quando um filho na lista expandida é clicado
- ExpandableListView.OnGroupClickListener : Isso é sobrescrito para implementar o método de retorno de chamada que é invocado quando um cabeçalho de grupo na lista expandida é clicado
- ExpandableListView.OnGroupCollapseListener : É usado para notificar quando um grupo é recolhido
- ExpandableListView.OnGroupExpandListener : É usado para notificar quando um grupo é expandido
Estrutura do Projeto Android ExpandableListView
Este projeto consiste em três classes.
- A MainActivity that shows the layout with the ExpandableListView
- Um ExpandableListDataPump que representa dados aleatórios em uma Lista e mapeia os dados do item filho para os respectivos cabeçalhos de grupo usando um HashMap
- A CustomExpandableListAdapter which provides the MainActivity with the data from the ExpandableListDataPump class/li>
Código do Android ExpandableListView
O layout activity_main.xml consiste em um ExpandableListView em um RelativeLayout, conforme mostrado abaixo: activity_main.xml
<RelativeLayout 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:paddingLeft="@dimen/activity_horizontal_margin"
android:paddingRight="@dimen/activity_horizontal_margin"
android:paddingTop="@dimen/activity_vertical_margin"
android:paddingBottom="@dimen/activity_vertical_margin"
tools:context=".MainActivity">
<ExpandableListView
android:id="@+id/expandableListView"
android:layout_height="match_parent"
android:layout_width="match_parent"
android:indicatorLeft="?android:attr/expandableListPreferredItemIndicatorLeft"
android:divider="@android:color/darker_gray"
android:dividerHeight="0.5dp" />
</RelativeLayout>
O android:indicatorLeft é o limite esquerdo para o indicador de itens. Observação: Não podemos usar o valor wrap_content para o atributo android:layout_height do ExpandableListView
em XML, a menos que o tamanho do pai seja estritamente especificado. O layout do cabeçalho do grupo de cada lista individual é fornecido abaixo: list_group.xml
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
android:orientation="vertical" android:layout_width="match_parent"
android:layout_height="match_parent">
<TextView
android:id="@+id/listTitle"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:paddingLeft="?android:attr/expandableListPreferredItemPaddingLeft"
android:textColor="@android:color/black"
android:paddingTop="10dp"
android:paddingBottom="10dp" />
</LinearLayout>
O layout da linha dos itens filhos é fornecido abaixo: list_item.xml
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
android:orientation="vertical" android:layout_width="match_parent"
android:layout_height="wrap_content">
<TextView
android:id="@+id/expandedListItem"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:paddingLeft="?android:attr/expandableListPreferredChildPaddingLeft"
android:paddingTop="10dp"
android:paddingBottom="10dp" />
</LinearLayout>
A classe ExpandableListDataPump
é definida da seguinte forma:
package com.journaldev.expandablelistview;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
public class ExpandableListDataPump {
public static HashMap<String, List<String>> getData() {
HashMap<String, List<String>> expandableListDetail = new HashMap<String, List<String>>();
List<String> cricket = new ArrayList<String>();
cricket.add("India");
cricket.add("Pakistan");
cricket.add("Australia");
cricket.add("England");
cricket.add("South Africa");
List<String> football = new ArrayList<String>();
football.add("Brazil");
football.add("Spain");
football.add("Germany");
football.add("Netherlands");
football.add("Italy");
List<String> basketball = new ArrayList<String>();
basketball.add("United States");
basketball.add("Spain");
basketball.add("Argentina");
basketball.add("France");
basketball.add("Russia");
expandableListDetail.put("CRICKET TEAMS", cricket);
expandableListDetail.put("FOOTBALL TEAMS", football);
expandableListDetail.put("BASKETBALL TEAMS", basketball);
return expandableListDetail;
}
}
No código acima, o objeto expandableListDetail
é usado para mapear as strings do cabeçalho do grupo para seus respectivos filhos usando um ArrayList de Strings. CustomExpandableListAdapter.java
package com.journaldev.expandablelistview;
import java.util.HashMap;
import java.util.List;
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;
public class CustomExpandableListAdapter extends BaseExpandableListAdapter {
private Context context;
private List<String> expandableListTitle;
private HashMap<String, List<String>> expandableListDetail;
public CustomExpandableListAdapter(Context context, List<String> expandableListTitle,
HashMap<String, List<String>> expandableListDetail) {
this.context = context;
this.expandableListTitle = expandableListTitle;
this.expandableListDetail = expandableListDetail;
}
@Override
public Object getChild(int listPosition, int expandedListPosition) {
return this.expandableListDetail.get(this.expandableListTitle.get(listPosition))
.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 = layoutInflater.inflate(R.layout.list_item, null);
}
TextView expandedListTextView = (TextView) convertView
.findViewById(R.id.expandedListItem);
expandedListTextView.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 = layoutInflater.inflate(R.layout.list_group, null);
}
TextView listTitleTextView = (TextView) 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;
}
}
Esta classe estende BaseExpandableListAdapter e substitui os métodos na classe base para fornecer a visualização para o ExpandableListView. O método getView() preenche os dados na visualização do item com o índice fornecido. MainActivity.java
package com.journaldev.expandablelistview;
import android.support.v7.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;
List<String> expandableListTitle;
HashMap<String, List<String>> expandableListDetail;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
expandableListView = (ExpandableListView) findViewById(R.id.expandableListView);
expandableListDetail = ExpandableListDataPump.getData();
expandableListTitle = new ArrayList<String>(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;
}
});
}
}
No código acima, implementamos todas as interfaces que foram discutidas anteriormente. Por uma questão de simplicidade, iremos apenas exibir um Toast com o nome do item ou o estado do grupo a cada clique. No entanto, esses podem ser facilmente modificados para realizar qualquer outra operação. Abaixo está nosso aplicativo com a visualização da lista expansível do Android em ação. Nota: As ExpandableListViews são roláveis por padrão. Isso encerra o tutorial da Android ExpandableListView. Você pode baixar o projeto final da Android ExpandableListView no link abaixo.
Source:
https://www.digitalocean.com/community/tutorials/android-expandablelistview-example-tutorial