什么是列表视图？

列表视图概述

1、继承关系图

• 列表视图（ListView）继承了抽象列表视图（AbsListView），而抽象列表视图又继承了适配器视图（AdapterView）。适配器视图具有共同的特征，就是利用适配器将数据源与展示控件绑定起来。
  

2、列表视图API文档

• https://developer.android.google.cn/reference/kotlin/android/widget/ListView?hl=en
  

3、列表视图四要素

要素	说明
列表控件	显示多项供用户选择
适配器	数组适配器、简单适配器、游标适配器、基适配器
数据源	数组、数组列表、游标……
列表项模板	平台资源、用户自定义

• 列表视图四要素：列表控件、适配器、列表项模板和数据源
  

4、四种常用适配器

• 列表视图（ListView），它是AdapterView的孙子类，要通过适配器作为梁桥来绑定数据源

适配器	含义
ArrayAdapter	数组适配器
SimpleAdapter	简单适配器
SimpleCursorAdapter	简单游标适配器
BaseAdapter	基适配器

数组适配器案例 - 阅读古诗

1、创建安卓应用

• 基于Empty Activity模板创建安卓应用 - Contacts
  

• 单击【Finish】按钮
  

2、准备图片素材

• 将背景图片拷贝到drawable目录
  

3、字符串资源文件

• 字符串资源文件 - strings.xml
  

• 字符串资源文件代码如下

<resources>
    <string name="app_name">通讯录</string>
    <string name="icon">图标</string>
    <string name="name">姓名</string>
    <string name="phone">电话</string>
</resources>

4、主布局资源文件

• 主布局资源文件 - activity_main.xml
  

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@drawable/background"
    android:orientation="vertical"
    android:padding="10dp">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="horizontal">

        <TextView
            android:id="@+id/tv_icon"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_marginRight="20dp"
            android:layout_weight="0.5"
            android:text="@string/icon"
            android:textColor="#000000"
            android:textSize="20sp" />

        <TextView
            android:id="@+id/tv_name"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:text="@string/name"
            android:textColor="#000000"
            android:textSize="20sp" />

        <TextView
            android:id="@+id/tv_phone"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="1.5"
            android:text="@string/phone"
            android:textColor="#000000"
            android:textSize="20sp" />
    </LinearLayout>

    <View
        android:layout_width="match_parent"
        android:layout_height="1dp"
        android:layout_marginTop="5dp"
        android:layout_marginBottom="5dp"
        android:background="#aaaaaa" />

    <ListView
        android:id="@+id/lv_contact"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />
</LinearLayout>

• 查看预览效果
  

5、创建联系人列表项模板

• 联系人列表项模板 - contact_list_item.xml
  

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:gravity="center_vertical"
        android:orientation="horizontal">

        <ImageView
            android:id="@+id/iv_icon"
            android:layout_width="60dp"
            android:layout_height="60dp"
            android:layout_marginRight="10dp"
            android:scaleType="fitXY"
            android:src="@drawable/img1" />

        <TextView
            android:id="@+id/tv_name"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:textColor="#0000ff"
            android:textSize="20sp" />

        <TextView
            android:id="@+id/tv_phone"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_marginLeft="70dp"
            android:textColor="#555555"
            android:textSize="16sp" />
    </LinearLayout>
</LinearLayout>

6、主界面类实现功能

• 主界面类 - MainActivity
  

• 声明变量
  

• 通过资源标识符获取控件实例
  

• 创建获取联系人列表的方法 - getContacts()
  

• 初始化联系人列表，作为列表控件的数据源
  

• 创建简单适配器，作为桥梁将数据源绑定到列表控件
  

• 给列表控件设置适配器
  

• 单击列表项，弹出吐司，显示联系人姓名和电话号码
  

package net.lh.contacts;


import androidx.appcompat.app.AppCompatActivity;

import android.os.Bundle;
import android.view.View;
import android.widget.AdapterView;
import android.widget.ListView;
import android.widget.SimpleAdapter;
import android.widget.Toast;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;

public class MainActivity extends AppCompatActivity {

    private ListView lvContact; // 联系人列表控件 - 展示
    private SimpleAdapter adapter; // 简单适配器 - 桥梁
    private List<HashMap<String, Object>> contacts; // 联系人列表 - 数据源

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // 利用布局资源文件设置用户界面
        setContentView(R.layout.activity_main);

        // 通过资源标识符获取控件实例
        lvContact = findViewById(R.id.lv_contact);

        // 初始化联系人列表，作为列表控件的数据源
        contacts = getContacts();

        // 创建简单适配器作为桥梁
        adapter = new SimpleAdapter(
                this, // 上下文 - 当前窗口
                contacts, // 数据源 - 联系人列表
                R.layout.contact_list_item, // 列表项模板 - 联系人列表项模板
                new String[] {"icon", "name", "phone"}, // 字段名数组
                new int[] {R.id.iv_icon, R.id.tv_name, R.id.tv_phone} // 控件标识数组
        );

        // 给列表控件设置适配器
        lvContact.setAdapter(adapter);

        // 给列表控件注册项单击监听器
        lvContact.setOnItemClickListener(new AdapterView.OnItemClickListener() {
            @Override
            public void onItemClick(AdapterView<?> adapterView, View view, int position, long id) {
                Toast.makeText(MainActivity.this,
                        contacts.get(position).get("name") + " " + contacts.get(position).get("phone"),
                        Toast.LENGTH_SHORT).show();
            }
        });
    }

    /**
     * 获取联系人列表
     *
     * @return 联系人列表
     */
    private List<HashMap<String, Object>> getContacts() {
        // 声明联系人列表
        List<HashMap<String, Object>> contacts = new ArrayList<>();

        // 声明联系人
        HashMap<String, Object> contact = null;

        // 创建第1个联系人
        contact = new HashMap<>();
        contact.put("icon", R.drawable.img1);
        contact.put("name", "李红梅");
        contact.put("phone", "15895953456");
        // 将联系人添加到联系人列表
        contacts.add(contact);

        // 创建第2个联系人
        contact = new HashMap<>();
        contact.put("icon", R.drawable.img2);
        contact.put("name", "王晓玲");
        contact.put("phone", "13956572345");
        // 将联系人添加到联系人列表
        contacts.add(contact);

        // 创建第3个联系人
        contact = new HashMap<>();
        contact.put("icon", R.drawable.img3);
        contact.put("name", "唐语涵");
        contact.put("phone", "15845891234");
        // 将联系人添加到联系人列表
        contacts.add(contact);

        // 创建第4个联系人
        contact = new HashMap<>();
        contact.put("icon", R.drawable.img4);
        contact.put("name", "佟大为");
        contact.put("phone", "13934345680");
        // 将联系人添加到联系人列表
        contacts.add(contact);

        // 创建第5个联系人
        contact = new HashMap<>();
        contact.put("icon", R.drawable.img5);
        contact.put("name", "钟小翠");
        contact.put("phone", "15890904520");
        // 将联系人添加到联系人列表
        contacts.add(contact);

        // 创建第6个联系人
        contact = new HashMap<>();
        contact.put("icon", R.drawable.img6);
        contact.put("name", "张三丰");
        contact.put("phone", "13890985670");
        // 将联系人添加到联系人列表
        contacts.add(contact);

        // 创建第7个联系人
        contact = new HashMap<>();
        contact.put("icon", R.drawable.img7);
        contact.put("name", "刘玉玲");
        contact.put("phone", "15895673450");
        // 将联系人添加到联系人列表
        contacts.add(contact);

        // 返回联系人列表
        return contacts;
    }
}

7、启动应用，查看效果

• 你单击列表项，弹出吐司