ListView
仅作为容器(列表),用于装载 & 显示数据(即 列表项Item
)- 而容器内的具体数据(列表项
Item
)则是由 适配器(Adapter
)提供
适配器(Adapter):作为View
和 数据之间的桥梁 & 中介,将数据映射到要展示的View
中
- 当需显示数据时,
ListView
会向Adapter
取出数据,从而加载显示,具体如下图
数组适配器 ArrayAdapter
适用于列表项只含有文本信息的情况
将数组适配器绑定在对话框上
1.创建一个按钮,并添加点击事件,打开添加了适配器的对话框
<Button
android:id="@+id/adpter_btn"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginTop="20dp"
android:onClick="popAlert"
android:text="数组适配器 ArrayAdapter" />
2.创建数组适配器
创建数据源
final String[] items= {"java","c++","android","flutter","dart"};
创建适配器中的每一项数据的样式布局
<!-- 适配器中每一项数据的样式布局 -->
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:gravity="center_vertical"
android:layout_width="match_parent"
android:layout_height="wrap_content">
<ImageView
android:layout_width="40dp"
android:layout_height="40dp"
android:src="@mipmap/star"/>
<TextView
android:id="@+id/arry_tx"
android:text="测试"
android:layout_marginLeft="15dp"
android:layout_width="wrap_content"
android:layout_height="wrap_content"/>
</LinearLayout>
实例化一个数组适配器
-
参数1 Context:环境上下文
-
参数2 resource:布局资源索引
-
参数3 int textViewResourceId:指定数据中文本需要放在布局中的文本控件的id
-
参数4 objects:数据源
ArrayAdapter arrayAdapter = new ArrayAdapter(this, R.layout.array_item_layout,R.id.arry_tx,items);
3.在对话框里添加适配器 .setAdapter()
-
参数1 - ListAdapter 适配器对象(对数据显示样式的规则制定器):The ListAdapter to supply the list of items
-
参数2 - OnClickListener 监听器 (可给可不给,不给则设为null)
// 实例化对话框
AlertDialog.Builder builder = new AlertDialog.Builder(this);
ArrayAdapter arrayAdapter = new ArrayAdapter(this, R.layout.array_item_layout,R.id.arry_tx,items);
builder.setTitle("请选择")
/* .setAdapter() 设置适配器
* 参数1 - ListAdapter 适配器对象(对数据显示样式的规则制定器):The ListAdapter to supply the list of items
* 参数2 - OnClickListener 监听器 (可给可不给,不给则设为null)*/
.setAdapter(arrayAdapter, new DialogInterface.OnClickListener() {
@Override
/int which 当前点击的item索引/
public void onClick(DialogInterface dialog, int which) {
Toast.makeText(ButtonActivity.this,items[which],Toast.LENGTH_SHORT).show();
}
})
.show();
简单适配器 SimpleAdapter
即可以处理列表项全是文本的情况,又可以处理列表项包含其他控件(如图片、文本、按钮等)情况
使用步骤
准备数据源
private void initData() {
Map<String,Object> data1 = new HashMap<>();
data1.put("icon",R.mipmap.star);
data1.put("name","沈成林");
data1.put("age",23);
Map<String,Object> data2 = new HashMap<>();
data2.put("icon",R.mipmap.star);
data2.put("name","杨滨溶");
data2.put("age",23);
Map<String,Object> data3 = new HashMap<>();
data3.put("icon",R.mipmap.star);
data3.put("name","朱一龙");
data3.put("age",23);
data.add(data1);
data.add(data2);
data.add(data3);
}
准备布局(适配器每一项数据的显示样式布局)
R.layout.simpleadapeter_item:
<?xml version="1.0" encoding="utf-8"?>
<!-- SimpleAdapter 的item样式-->
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="horizontal">
<ImageView
android:id="@+id/headIcon"
android:layout_width="50dp"
android:layout_height="65dp"
android:background="@mipmap/study" />
<TextView
android:id="@+id/itemName"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginStart="28dp"
android:layout_toEndOf="@+id/headIcon"
android:text="name"
android:textSize="26sp" />
<TextView
android:id="@+id/itemAge"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_below="@id/itemName"
android:layout_marginLeft="30dp"
android:layout_marginTop="13dp"
android:layout_toRightOf="@id/headIcon"
android:text="TextView"
android:textColor="#F44336"
android:textStyle="bold" />
</RelativeLayout>
实例化一个简单适配器
public SimpleAdapter(Context context, List<? extends Map<String, ?>> data, @LayoutRes int resource, String[] from, @IdRes int[] to)
参数1:环境上下文
参数2:数据源
参数3:每一项布局(列表项布局) R.layout.simpleadapeter_item
参数4:数据来源的key数组,一个String数据,对应到Map上的每个<key,value>的key值
参数5:是一个int数组,对应resource列表项布局文件里面每个控件的id,需要与上面String[] from的from相对应
key所指代的数据会在to数组中id所代表的控件上显示出来
String[] from = {"icon","name","age"}; // 参数4
int[] to = {R.id.headIcon,R.id.itemName,R.id.itemAge}; // 参数5
SimpleAdapter simpleAdapter = new SimpleAdapter(this,data,R.layout.simpleadapeter_item,from,to);
通过ListView来展示
1.添加ListView控件,xml文件
<LinearLayout
android:layout_width="match_parent"
android:layout_height="0dp"
android:layout_weight="4">
<ListView
android:id="@+id/list1"
android:layout_width="match_parent"
android:layout_height="match_parent" />
</LinearLayout>
2.将ListView控件绑定在 SimpleAdapter 上
ListView listView = findViewById(R.id.list1);
listView.setAdapter(simpleAdapter);
3.为listView设置item点击事件
listView.setOnItemClickListener(new AdapterView.OnItemClickListener() {
Override
public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
/*数据源data是一个List<Map<String,Object>>的列表,
*onItemClick方法,返回的position就是当前点击的 item 的位序,通过它可以拿到item的数据源
*view 就是点击的item的视图*/
Map<String,Object> data1 = data.get(position);
Toast.makeText(ListViewActivity.this,"姓名"+data1.get("name")+",年龄:"+data1.get("age"),Toast.LENGTH_SHORT).show();
}
});
基本适配器 BaseAdapter
根据xml文件中定义的样式进行列表项的填充,完全自定义数据适配方式,适用性最强
准备列表项布局 R.layout.baseadapter_item
<?xml version="1.0" encoding="utf-8"?>
<!-- 1. BaseAdapter item的样式设计-->
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent">
<ImageView
android:id="@+id/base_icon"
android:src="@mipmap/study"
android:layout_width="80dp"
android:layout_margin="5dp"
android:layout_height="80dp"/>
<TextView
android:id="@+id/base_name"
android:layout_width="match_parent"
android:layout_height="40dp"
android:text="nickName"
android:layout_toRightOf="@+id/base_icon"
android:layout_margin="5dp"
android:textSize="26sp" />
<TextView
android:id="@+id/base_time"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_margin="5dp"
android:layout_alignStart="@+id/base_name"
android:layout_toRightOf="@+id/base_icon"
android:layout_below="@+id/base_name"
android:textSize="22sp"
android:text="2023-12-4" />
<TextView
android:id="@+id/base_content"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_below="@+id/base_icon"
android:textSize="26sp"
android:text="这是内容" />
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_below="@+id/base_content"
android:layout_marginTop="20dp"
android:orientation="horizontal">
<ImageView
android:id="@+id/base_icon1"
android:layout_width="40dp"
android:layout_height="50dp"
android:layout_weight="1"
android:src="@mipmap/star" />
<ImageView
android:id="@+id/base_icon2"
android:layout_width="40dp"
android:layout_height="50dp"
android:layout_weight="1"
android:src="@mipmap/star" />
<ImageView
android:id="@+id/base_icon3"
android:layout_width="40dp"
android:layout_height="50dp"
android:layout_weight="1"
android:src="@mipmap/star" />
</LinearLayout>
</RelativeLayout>
准备数据源
准备一个数据对象 BaseMsg类
package com.example.androidstudiostudy.data;
// 2.1 准备数据源 - BaseAdapter 的数据源类
public class BaseMsg {
private int icon;
private String nickName;
private String content;
public int getIcon() {
return icon;
}
public void setIcon(int icon) {
this.icon = icon;
}
public String getNickName() {
return nickName;
}
public void setNickName(String nickName) {
this.nickName = nickName;
}
public String getContent() {
return content;
}
public void setContent(String content) {
this.content = content;
}
public boolean isLike() {
return isLike;
}
public void setLike(boolean like) {
isLike = like;
}
private boolean isLike;
public BaseMsg(int icon, String nickName, String content, boolean isLike) {
this.icon = icon;
this.nickName = nickName;
this.content = content;
this.isLike = isLike;
}
}
初始化一个 BaseMsg 列表
private List<BaseMsg> lists = new ArrayList<>(); // 定义一个 BaseMsg 对象的列表
private int[] touxiang ={R.mipmap.star,R.mipmap.study,R.mipmap.star,R.mipmap.study,R.mipmap.star,R.mipmap.study,R.mipmap.star,R.mipmap.study,}; // 定义一个int类型的数组,里面存放 图标的id
// 初始化 BaseMsg 对象的列表
public void initBaseListData() {
for (int i = 0; i < 8; i++) {
BaseMsg baseMsg = new BaseMsg(touxiang[i], "用户" + (i+1), "这是第" + (i+1) + "段代码", false);
lists.add(baseMsg);
}
}
构建 BaseAdapter 适配器
新建一个继承自 BaseAdapter 的类,在这个类中对每一个item的布局进行设计
要求传入 环境上下文、数据源
package com.example.androidstudiostudy;
import android.content.Context;
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 android.widget.Toast;
import com.example.androidstudiostudy.data.BaseMsg;
import java.util.List;
// 新建一个继承自 BaseAdapter 的类
// 根据准备好的数据源和子项布局完成 ListView 效果的一一设置
public class MyBaseAdapter extends BaseAdapter {
private List<BaseMsg> baseMsgList;
private Context context;
// 构造方法
public MyBaseAdapter(List<BaseMsg> baseMsgList,Context context) {
this.baseMsgList = baseMsgList;
this.context = context;
}
// 获取数量(设置listView的长度)
@Override
public int getCount() {
return baseMsgList.size();
}
@Override
// 获取视图(设置 listView 每一项的显示效果)
/* 参数1:当前Item的下标 --- 和数据源的下标相同,可以由此获取数据源配置item
* 参数2:当前Item的view
* 参数3:当前视图的父视图(可调整当前视图的宽高)*/
public View getView(int position, View convertView, ViewGroup parent) {
// 完成对view的设置
// 将设置好的 item 布局资源转换成view
convertView = LayoutInflater.from(context).inflate(R.layout.baseadapter_item,null); // 此时得到的是最初的item布局,没有添加的数据
// 获取数据源[position] 的数据,并将他们设置到item视图中的控件中
BaseMsg m = baseMsgList.get(position); // 获取item的数据列表
ImageView imageView = convertView.findViewById(R.id.base_icon);
imageView.setImageResource(m.getIcon());
TextView tN = convertView.findViewById(R.id.base_name);
tN.setText(m.getNickName());
TextView tC = convertView.findViewById(R.id.base_content);
tC.setText(m.getContent());
// 可以给item的单个控件设置点击事件
tN.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
// System.out.printf("点击了"+tN.getText());
Toast.makeText(context,"你点击了"+m.getNickName(),Toast.LENGTH_SHORT).show();
}
});
return convertView;
}
@Override
public Object getItem(int position) {
return null;
}
@Override
public long getItemId(int position) {
return 0;
}
}
// 获取视图(设置 listView 每一项的显示效果)
/* 参数1:当前Item的下标 --- 和数据源的下标相同,可以由此获取数据源配置item
* 参数2:当前Item的view
* 参数3:当前视图的父视图(可调整当前视图的宽高)*/
public View getView(int position, View convertView, ViewGroup parent)
实例化 BaseAdapter 适配器
BaseAdapter baseAdapter = new MyBaseAdapter(lists,this);
通过ListView展示
initBaseListData();
listView.setAdapter(baseAdapter);
动态添加
// 动态添加 BaseAdapter 数据源中的数据
public void addData(View view) {
lists.add(new BaseMsg(R.mipmap.ic_launcher,"新name","这是新增的",false));
// 通知适配器更新
baseAdapter.notifyDataSetChanged();
// 设置listView自动显示到最新的数据
listView.setTranscriptMode(AbsListView.TRANSCRIPT_MODE_ALWAYS_SCROLL);
}
列表自动滑动到底部 :TRANSCRIPT_MODE_ALWAYS_SCROLL
/**
* The list will automatically scroll to the bottom, no matter what items
* are currently visible.
*
* @see #setTranscriptMode(int)
*/
// 列表自动滑动到底部
public static final int TRANSCRIPT_MODE_ALWAYS_SCROLL = 2;