文章目录
一、导读
- 列表视图是基于适配器的供用户从多个选项中进行选择控件,可以通过滑动显示很多列表项。
二、列表视图的概述
1、继承关系图
- 列表视图(ListView)继承了抽象列表视图(AbsListView),而抽象列表视图又继承了适配器视图(AdapterView)。适配器视图具有共同的特征,就是利用适配器将数据源与展示控件绑定起来。
2、列表视图API文档
3、列表视图四要素
要素 | 说明 |
---|---|
列表控件 | 显示多项供用户选择 |
适配器 | 数组适配器、简单适配器、游标适配器、基适配器 |
数据源 | 数组、数组列表、游标…… |
列表项模板 | 平台资源、用户自定义 |
4、四种常用适配器
- 列表视图(ListView),它是AdapterView的孙子类,要通过适配器作为梁桥来绑定数据源
适配器 | 含义 |
---|---|
ArrayAdapter | 数组适配器 |
SimpleAdapter | 简单适配器 |
SimpleCursorAdapter | 简单游标适配器 |
BaseAdapter | 基适配器 |
三、案列演示
1、数组适配器案列—阅读古诗
(1) 、准备工作
- 基于
Empty Activity
模板创建安卓应用 -ReadAncientPoetry
- 修改字符串资源文件 -
strings.xml
<resources>
<string name="app_name">阅读古诗</string>
<string name="back">返回</string>
<string-array name="titles">
<item>静夜思</item>
<item>登鹳雀楼</item>
<item>相思</item>
<item>听弹琴</item>
<item>登乐游原</item>
<item>朝发白帝城</item>
<item>巴山夜雨</item>
<item>渭城曲</item>
<item>春夜喜雨</item>
<item>离离原上草</item>
<item>示儿</item>
</string-array>
<string-array name="authors">
<item>唐·李白</item>
<item>唐·王之涣</item>
<item>唐·王维</item>
<item>唐·刘长卿</item>
<item>唐·李商隐</item>
<item>唐·李白</item>
<item>唐·杜牧</item>
<item>唐·王维</item>
<item>唐·杜甫</item>
<item>唐·白居易</item>
<item>宋·陆游</item>
</string-array>
<string-array name="contents">
<item>床前明月光,\n疑是地上霜。\n举头望明月,\n低头思故乡。</item>
<item>白日依山尽,\n黄河入海流。\n欲穷千里目,\n更上一层楼。</item>
<item>红豆生南国,\n春来发几枝。\n愿君多采撷,\n此物最相思。</item>
<item>泠泠七弦上,\n静听松风寒。\n古调虽自爱,\n今人多不弹。</item>
<item>向晚意不适,\n驱车登古原。\n夕阳无限好,\n只是近黄昏。</item>
<item>朝辞白帝彩云间,\n千里江陵一日还。\n两岸猿声啼不住,\n轻舟已过万重山。</item>
<item>君问归期未有期,\n巴山夜雨涨秋池。\n何当共剪西窗烛,\n却话巴山夜雨时。</item>
<item>渭城朝雨浥轻尘,\n客舍青青柳色新。\n劝君更尽一杯酒,\n西出阳关无故人。</item>
<item>好雨知时节,当春乃发生。\n随风潜入夜,润物细无声。\n野径云俱黑,江船火独明。\n晓看红湿处,花重锦官城。</item>
<item>离离原上草,一岁一枯荣。\n野火烧不尽,春风吹又生。\n远芳侵古道,晴翠接荒城。\n又送王孙去,萋萋满别情。</item>
<item>死去元知万事空,\n但悲不见九州同。\n王师北定中原日,\n家祭无忘告乃翁。 </item>
</string-array>
</resources>
- 主布局资源文件 -
activity_main.xml
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout 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:padding="15dp"
tools:context=".MainActivity">
<ListView
android:id="@+id/lv_poem_title"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:divider="#aaaaaa"
android:dividerHeight="0.5dp"
/>
</LinearLayout>
(2) 、创建诗歌列表项模板
- 诗歌列表项模板 -
poem_list_item.xml
(3) 、主界面类实现(MainActivity)
-
声明变量
-
初始化标题数组,作为列表控件的数据源
-
创建数组适配器,作为连接列表控件与数据源的桥梁
-
给列表控件设置适配器
- 查看源代码
package net.hw.read_ancient_poetry;
import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.ArrayAdapter;
import android.widget.ListView;
public class MainActivity extends AppCompatActivity {
private ListView lvPoemTitle; // 诗歌标题列表控件 - 展示
private ArrayAdapter<String> adapter; // 数组适配器 - 桥梁
private String[] titles; // 诗歌标题数组 - 数据源
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// 利用布局资源文件设置用户界面
setContentView(R.layout.activity_main);
// 通过资源标识符获取控件实例
lvPoemTitle = findViewById(R.id.lv_poem_title);
// 初始化古诗标题数组,作为列表控件的数据源
titles = getResources().getStringArray(R.array.titles);
// 给古诗标题填上序号
for (int i = 0; i < titles.length; i++) {
titles[i] = (i + 1) + ". " + titles[i];
}
// 创建数组适配器,作为连接列表控件与数据源的桥梁
adapter = new ArrayAdapter<>(
this, // 上下文 - 当前窗口
android.R.layout.simple_list_item_1, // 列表项模板 - 平台布局资源
titles // 数据源 - 字符串数据组
);
// 给列表控件设置适配器
lvPoemTitle.setAdapter(adapter);
}
}
- 启动应用查看效果
6、修改源代码,使用自定义的列表项模板
- 重启应用,查看效果
(4) 、单击列表项,弹出吐司
- 修改主界面类,给列表控件注册项单击监听器
- 参数position是从0开始,所以用户点击+1;
- 参数
id
的值与参数position
的值相等,两个参数只是类型不同
而已
- 重启应用查看效果
(5) 、创建内容界面
- 基于模板创建显示古诗内容的界面 -
ContentActivity
- 布局资源文件
<?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:gravity="center"
android:orientation="vertical">
<TextView
android:id="@+id/tv_title"
android:layout_width="wrap_content"
android:layout_height="0dp"
android:layout_marginTop="30dp"
android:layout_marginBottom="20dp"
android:layout_weight="1"
android:gravity="center_vertical"
android:textColor="#ff00ff"
android:textSize="40sp" />
<TextView
android:id="@+id/tv_author"
android:layout_width="wrap_content"
android:layout_height="0dp"
android:layout_marginBottom="20dp"
android:layout_weight="1"
android:gravity="center_vertical"
android:textColor="#000000"
android:textSize="25sp" />
<TextView
android:id="@+id/tv_content"
android:layout_width="wrap_content"
android:layout_height="0dp"
android:layout_marginBottom="20dp"
android:layout_weight="8"
android:textColor="#0000ff"
android:textSize="30sp" />
<Button
android:id="@+id/btn_back"
android:layout_width="match_parent"
android:layout_height="0dp"
android:layout_weight="1"
android:onClick="doBack"
android:text="@string/back"
android:textSize="20sp" />
</LinearLayout>
- 修改主界面类,实现窗口跳转
(6) 、修改古诗内容界面类
- 声明变量
- 通过意图获取信息
- 关闭窗口
- 源代码
public class ContentActivity extends AppCompatActivity {
private TextView tvTitle; // 标题标签
private TextView tvAuthor; // 作者标签
private TextView tvContent; // 内容标签
private String[] titles; //
private String[] authors;
private String[] contents; // 内容
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_content);
tvTitle = findViewById(R.id.tv_title);
tvAuthor = findViewById(R.id.tv_author);
tvContent = findViewById(R.id.tv_content);
// 获取窗口跳转的意图
Intent intent = getIntent();
// 判断意图是否为空
if(intent != null){
// 获取意图携带的位置数据
int position = intent.getIntExtra("position",0);
// 获取标题
titles = getResources().getStringArray(R.array.titles);
authors = getResources().getStringArray(R.array.authors);
contents = getResources().getStringArray(R.array.contents);
// 设置标题,作者,内容标签文本
tvTitle.setText(titles[position]);
tvAuthor.setText(authors[position]);
tvContent.setText(contents[position]);
}
}
/**
* 返回
* @param view
*/
public void doBack(View view){
finish();
}
}
2、简单适配器案例—通讯录
(1) 、准备工作
- 基于
Empty Activity
模板创建安卓应用 -Contacts
- 准备7张小图片拷贝到
drawable
- 字符串资源修改
- 主布局资源的修改
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout 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:orientation="vertical"
android:padding="10dp"
tools:context=".MainActivity">
<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: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: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: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">
</ListView>
</LinearLayout>
(2) 、创建联系人列表项模板(contact_list_item.xml)
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout 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:orientation="vertical"
android:padding="10dp"
tools:context=".MainActivity">
<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: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: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: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">
</ListView>
</LinearLayout>
(3) 、主类功能的实现(MainActivity)
- 声明变量
- 初始化联系人列表,作为列表控件的数据源
- 创建简单适配器作为桥梁
- 创建获取联系人列表的方法 -
getContacts()
/**
* @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;
}
- 单击联系人吐司内容
- 查看源代码
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<?> parent, View view, int position, long id) {
Toast.makeText(MainActivity.this,contacts.get(position).get("name")+" ", 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;
}