Hướng dẫn sử dụng Android ListView
Công ty Vĩnh Cửu tuyển dụng lập trình viên Java

1- ListView là gì?

ListView là một view group, hiển thị các thành phần (elements) theo một danh sách, có thể cuộn được theo chiều thẳng đứng. ListView là một view quan trọng, nó được sử dụng rộng rãi trong các ứng dụng Android. Một ví dụ đơn giản của ListView là cuốn sách liên lạc của bạn, nơi bạn có một danh sách các địa chỉ liên lạc của bạn hiển thị trong một ListView.
Ngoài ListView, Android cũng cung cấp cho bạn một view tương tự khác là ExpandableListView.

1.1- ListItem

Một ListView được tạo từ một danh sách các ListItem. ListItem là một dòng (row) riêng lẻ trong listview nơi mà dữ liệu sẽ được hiển thị. Bất kỳ dữ liệu nào trong listview chỉ được hiển thị thông qua listItem. Có thể coi listview như là một nhóm cuộn của các ListItem.
Một ListItem là một mảnh giao diện, nó có thể được làm bởi một số View.

Android xây dựng sẵn một số mẫu ListItem khác nhau, chúng được gọi là các Layout định nghĩa sẵn, sẽ được tôi đề cập trong các ví dụ của tài liệu này.

1.2- Adapter (Bộ tiếp nối)

Android Adapter (Tạm dịch là bộ tiếp nối)  là một cầu nối giữa các View (ví dụ như ListView) và các dữ liệu cơ bản cho View đó. Một Adapter quản lý dữ liệu và ghép nối với các dòng riêng lẻ (ListItems) của view.

Chúng ta ràng buộc các Adapter với Android ListView thông qua phương thức setAdapter. Bây giờ, Chúng ta hãy xem làm thế nào Adapter làm việc với sự giúp đỡ của hình ảnh sau đây.

AdapterView

Có nhiều View cần tới Android Adapter để quản lý dữ liệu hiển thị, các View này là con của class AdapterView, bạn có thể xem ở hình minh họa dưới đây:

Android Adapter

1.3- ListView Selector

Để ListView hiển thị đẹp hơn, bạn cần phải tùy biến các hiệu ứng, chẳng hạn khi đổi mầu nền của ListItem khi con trỏ di chuyển trên nó hoặc đổi mầu nền khi ListItem nó được chọn. Bạn có thể xem ví dụ tùy biến ListView Selector ở cuối tài liệu này.

2- ListView cơ bản sử dụng ArrayAdapter

2.1- ArrayAdapter

ArrayAdapter sử dụng để hiển thị các ListView với các ListItem đơn giản, ListItem có thể làm từ duy nhất một TextView, CheckedTextView, EditText,...

Trong trường hợp bạn muốn có một ListView với ListItem phức tạp hơn, bạn có thể tự tạo ra một Adapter tùy biến.

2.2- Ví dụ ListView với ArrayAdapter

Tạo mới Project với tên SimpleListView.
  • activity_main.xml
activity_main.xml
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
   xmlns:tools="http://schemas.android.com/tools"
   android:layout_width="match_parent"
   android:layout_height="match_parent"
   android:paddingBottom="@dimen/activity_vertical_margin"
   android:paddingLeft="@dimen/activity_horizontal_margin"
   android:paddingRight="@dimen/activity_horizontal_margin"
   android:paddingTop="@dimen/activity_vertical_margin"
   tools:context="org.o7planning.simplelistview.MainActivity">

   <ListView
       android:layout_width="wrap_content"
       android:layout_height="wrap_content"
       android:id="@+id/listView"
       android:layout_alignParentTop="true"
       android:layout_centerHorizontal="true" />
   
</RelativeLayout>
UserAccount.java
package org.o7planning.simplelistview;

import java.io.Serializable;

public class UserAccount implements Serializable {

   private String userName;
   private String userType;

   private boolean active;

   public UserAccount(String userName, String userType)  {
       this.userName= userName;
       this.userType = userType;
       this.active= true;
   }

   public UserAccount(String userName, String userType, boolean active)  {
       this.userName= userName;
       this.userType = userType;
       this.active= active;
   }

   public String getUserType() {
       return userType;
   }

   public void setUserType(String userType) {
       this.userType = userType;
   }

   public String getUserName() {
       return userName;
   }

   public void setUserName(String userName) {
       this.userName = userName;
   }

   public boolean isActive() {
       return active;
   }

   public void setActive(boolean active) {
       this.active = active;
   }

   @Override
   public String toString() {
       return this.userName +" ("+ this.userType+")";
   }

}
MainActivity.java
package org.o7planning.simplelistview;

import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.ArrayAdapter;
import android.widget.ListView;

public class MainActivity extends AppCompatActivity {

   @Override
   protected void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);
       setContentView(R.layout.activity_main);

       ListView listView = (ListView)findViewById(R.id.listView);

       //

       UserAccount tom = new UserAccount("Tom","admin");
       UserAccount jerry = new UserAccount("Jerry","user");
       UserAccount donald = new UserAccount("Donald","guest", false);

       UserAccount[] users = new UserAccount[]{tom,jerry, donald};

       // android.R.layout.simple_list_item_1: Là một hằng số Layout định nghĩa sẵn của Android
       // ý nghĩa của nó là ListView với ListItem đơn giản (Duy nhất một TextView).

       ArrayAdapter<UserAccount> arrayAdapter
               = new ArrayAdapter<UserAccount>(this, android.R.layout.simple_list_item_1 , users);


       listView.setAdapter(arrayAdapter);
   }


}
Chạy ví dụ:

2.3- Các Layout có sẵn làm việc với ArrayAdapter

Android xây dựng sẵn một số Layout (của ListItem) có thể làm việc với ArrayAdapter.

android.R.layout.simple_list_item_1

  • Đây là layout đơn giản của ListItem, được tạo bởi duy nhất một TextView (Bạn có thể xem ví dụ ở trên).

android.R.layout.simple_list_item_checked
   &
android.R.layout.simple_list_item_multiple_choice

  • 2 Layout trên là layout đơn giản để tạo ra một ListView với ListItem có một checkbox.
Bạn có thể xem ví dụ này tại đây:

3- Tùy biến ListView sử dụng BaseAdapter

Bạn có thể xây dựng tùy biến một ListViewer. Adapter của bạn nên mở rộng từ class BaseAdapter.

3.1- Ví dụ ListView tùy biến

Tạo một "Empty Activity" project có tên CustomListView.
Đây là hình ảnh ứng dụng sẽ làm:
Trước hết bạn cần chuẩn bị một vài file ảnh:
Copy và paste các file ảnh này vào thư mục mipmap:
  1. vi.png 
  2. us.png
  3. ru.png
Bạn cần tạo List item layouts. Trên Android Studio nhấn phải chuột vào res/layout chọn:
  • New/Layout resource file
Nhập vào:
  • File name: list_item_layout.xml
  • Root element: RelativeLayout
Thiết kế giao diện của List Item.
Slider các bước thiết kế giao diện của List Item:
  • SLIDER
ImageView
  • ID: imageView_flag

TextView 1:
  • ID: textView_countryName
  • Text: Country Name

TextView 2:
  • ID: textView_population
  • Text: Population ....
list_item_layout.xml
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent" android:layout_height="match_parent">

    <ImageView
        android:layout_width="64dp"
        android:layout_height="64dp"
        android:id="@+id/imageView_flag"
        android:layout_alignParentTop="true"
        android:layout_alignParentLeft="true"
        android:layout_alignParentStart="true"
        android:layout_marginLeft="5dp"
        android:layout_marginRight="5dp"
        android:layout_marginTop="5dp" />

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textAppearance="?android:attr/textAppearanceLarge"
        android:text="Country Name"
        android:id="@+id/textView_countryName"
        android:layout_alignParentTop="true"
        android:layout_toRightOf="@+id/imageView_flag"
        android:layout_alignParentRight="true"
        android:layout_alignParentEnd="true"
        android:layout_above="@+id/textView_population"
        android:layout_margin="5dp" />

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textAppearance="?android:attr/textAppearanceSmall"
        android:text="Population: ..."
        android:id="@+id/textView_population"
        android:layout_alignBottom="@+id/imageView_flag"
        android:layout_alignLeft="@+id/textView_countryName"
        android:layout_alignStart="@+id/textView_countryName"
        android:layout_alignParentRight="true"
        android:layout_alignParentEnd="true"
        android:layout_margin="5dp" />

</RelativeLayout>
Country.java
package org.o7planning.countrieslistview;

package org.o7planning.customlistview;



public class Country {

   private String countryName;

   // Image name (Without extension)
   private String flagName;
   private int population;

   public Country(String countryName, String flagName, int population) {
       this.countryName= countryName;
       this.flagName= flagName;
       this.population= population;
   }

   public int getPopulation() {
       return population;
   }

   public void setPopulation(int population) {
       this.population = population;
   }

   public String getCountryName() {
       return countryName;
   }

   public void setCountryName(String countryName) {
       this.countryName = countryName;
   }

   public String getFlagName() {
       return flagName;
   }

   public void setFlagName(String flagName) {
       this.flagName = flagName;
   }

   @Override
   public String toString()  {
       return this.countryName+" (Population: "+ this.population+")";
   }
}
  • activity_main.xml
activity_main.xml
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
   xmlns:tools="http://schemas.android.com/tools"
   android:layout_width="match_parent"
   android:layout_height="match_parent"
   android:paddingBottom="@dimen/activity_vertical_margin"
   android:paddingLeft="@dimen/activity_horizontal_margin"
   android:paddingRight="@dimen/activity_horizontal_margin"
   android:paddingTop="@dimen/activity_vertical_margin"
   tools:context="org.o7planning.customlistview.MainActivity">

   <ListView
       android:layout_width="wrap_content"
       android:layout_height="wrap_content"
       android:id="@+id/listView"
       android:layout_alignParentTop="true"
       android:layout_centerHorizontal="true" />
   
</RelativeLayout>
CustomListAdapter là class mở rộng từ BaseAdapter, nó làm nhiệm vụ hiển thị dữ liệu lên các List Item.
CustomListAdapter.java
package org.o7planning.customlistview;


import android.content.Context;
import android.util.Log;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.BaseAdapter;
import android.widget.ImageView;
import android.widget.TextView;
import java.util.List;

public class CustomListAdapter  extends BaseAdapter {

  private List<Country> listData;
  private LayoutInflater layoutInflater;
  private Context context;

  public CustomListAdapter(Context aContext,  List<Country> listData) {
      this.context = aContext;
      this.listData = listData;
      layoutInflater = LayoutInflater.from(aContext);
  }

  @Override
  public int getCount() {
      return listData.size();
  }

  @Override
  public Object getItem(int position) {
      return listData.get(position);
  }

  @Override
  public long getItemId(int position) {
      return position;
  }

  public View getView(int position, View convertView, ViewGroup parent) {
      ViewHolder holder;
      if (convertView == null) {
          convertView = layoutInflater.inflate(R.layout.list_item_layout, null);
          holder = new ViewHolder();
          holder.flagView = (ImageView) convertView.findViewById(R.id.imageView_flag);
          holder.countryNameView = (TextView) convertView.findViewById(R.id.textView_countryName);
          holder.populationView = (TextView) convertView.findViewById(R.id.textView_population);
          convertView.setTag(holder);
      } else {
          holder = (ViewHolder) convertView.getTag();
      }

      Country country = this.listData.get(position);
      holder.countryNameView.setText(country.getCountryName());
      holder.populationView.setText("Population: " + country.getPopulation());

      int imageId = this.getMipmapResIdByName(country.getFlagName());

      holder.flagView.setImageResource(imageId);

      return convertView;
  }

  // Tìm ID của Image ứng với tên của ảnh (Trong thư mục mipmap).
  public int getMipmapResIdByName(String resName)  {
      String pkgName = context.getPackageName();

      // Trả về 0 nếu không tìm thấy.
      int resID = context.getResources().getIdentifier(resName , "mipmap", pkgName);
      Log.i("CustomListView", "Res Name: "+ resName+"==> Res ID = "+ resID);
      return resID;
  }

  static class ViewHolder {
      ImageView flagView;
      TextView countryNameView;
      TextView populationView;
  }

}
ActivityMain.java
package org.o7planning.customlistview;

import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;


import android.view.View;
import android.widget.AdapterView;
import android.widget.ListView;
import android.widget.Toast;
import java.util.ArrayList;
import java.util.List;

public class MainActivity extends AppCompatActivity {

   @Override
   protected void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);
       setContentView(R.layout.activity_main);


       List<Country> image_details = getListData();
       final ListView listView = (ListView) findViewById(R.id.listView);
       listView.setAdapter(new CustomListAdapter(this, image_details));

       // Khi người dùng click vào các ListItem
       listView.setOnItemClickListener(new AdapterView.OnItemClickListener() {

           @Override
           public void onItemClick(AdapterView<?> a, View v, int position, long id) {
               Object o = listView.getItemAtPosition(position);
               Country country = (Country) o;
               Toast.makeText(MainActivity.this, "Selected :" + " " + country, Toast.LENGTH_LONG).show();
           }
       });
   }

   private  List<Country> getListData() {
       List<Country> list = new ArrayList<Country>();
       Country vietnam = new Country("Vietnam", "vn", 98000000);
       Country usa = new Country("United States", "us", 320000000);
       Country russia = new Country("Russia", "ru", 142000000);


       list.add(vietnam);
       list.add(usa);
       list.add(russia);

       return list;
   }

}
Chạy ứng dụng:

3.2- Ví dụ Tùy biến Selector

Để ListView hiển thị đẹp hơn, bạn cần phải tùy biến các hiệu ứng, chẳng hạn khi đổi mầu nền của ListItem khi con trỏ di chuyển trên nó hoặc đổi mầu nền khi ListItem nó được chọn. Chúng ta tiếp tục với ví dụ ở trên.
Tạo các file cấu hình:
  • File name: list_item_normal.xml
  • Directory: drawable
Tương tự tạo mới 3 file khác:
  • item_state_pressed.xml
  • item_state_selected.xml
  • list_selector.xml
Khi List Item ở trạng thái bình thường các style sét đặt trong item_state_normal.xml sẽ được áp dụng cho ListItem.
item_state_normal.xml
<?xml version="1.0" encoding="utf-8"?>

<shape xmlns:android="http://schemas.android.com/apk/res/android"
  android:shape="rectangle">

  <gradient
      android:startColor="#f1f1f2"
      android:centerColor="#e7e7e8"
      android:endColor="#cfcfcf"
      android:angle="270" />

</shape>
Khi List Item bị nhấn các style sét đặt trong item_state_pressed.xml sẽ được áp dụng cho ListItem
item_state_pressed.xml
<?xml version="1.0" encoding="utf-8"?>

<shape xmlns:android="http://schemas.android.com/apk/res/android"
  android:shape="rectangle">

  <gradient
      android:startColor="#18d7e5"
      android:centerColor="#16cedb"
      android:endColor="#09adb9"
      android:angle="270" />

</shape>
Khi List Item được chọn các style sét đặt trong item_state_selected.xml sẽ được áp dụng cho ListItem
item_state_selected.xml
<?xml version="1.0" encoding="utf-8"?>

<shape xmlns:android="http://schemas.android.com/apk/res/android"
  android:shape="rectangle">

  <gradient
      android:startColor="#18d7e5"
      android:centerColor="#16cedb"
      android:endColor="#09adb9"
      android:angle="270" />

</shape>
Gắn các trạng thái cụ thể của List Item với các file xml.
list_selector.xml
<?xml version="1.0" encoding="utf-8"?>

<selector xmlns:android="http://schemas.android.com/apk/res/android">

       <item
           android:state_selected="false"
           android:state_pressed="false"
           android:drawable="@drawable/item_state_normal" />

       <item android:state_pressed="true"
           android:drawable="@drawable/item_state_pressed" />

       <item android:state_selected="true"
           android:state_pressed="false"
           android:drawable="@drawable/item_state_selected" />


</selector>
Sét đặt ListSelector cho ListView:
activity_main.xml
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
   xmlns:tools="http://schemas.android.com/tools"
   android:layout_width="match_parent"
   android:layout_height="match_parent"
   android:paddingBottom="@dimen/activity_vertical_margin"
   android:paddingLeft="@dimen/activity_horizontal_margin"
   android:paddingRight="@dimen/activity_horizontal_margin"
   android:paddingTop="@dimen/activity_vertical_margin"
   tools:context="org.o7planning.customlistview.MainActivity">

   <ListView
       android:layout_width="wrap_content"
       android:layout_height="wrap_content"
       android:id="@+id/listView"
       android:layout_alignParentTop="true"
       android:layout_centerHorizontal="true"
       android:listSelector="@drawable/list_selector" />

</RelativeLayout>
Chạy lại ứng dụng của bạn.