ListView
仅作为容器(列表),用于装载 & 显示数据(即 列表项Item
)- 而容器内的具体数据(列表项
Item
)则是由 适配器(Adapter
)提供
适配器(Adapter):作为View
和 数据之间的桥梁 & 中介,将数据映射到要展示的View
中
- 当需显示数据时,
ListView
会向Adapter
取出数据,从而加载显示,具体如下图
数组适配器 ArrayAdapter
适用于列表项只含有文本信息的情况
将数组适配器绑定在对话框上
1.创建一个按钮,并添加点击事件,打开添加了适配器的对话框
<Buttonandroid: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"><ImageViewandroid:layout_width="40dp"android:layout_height="40dp"android:src="@mipmap/star"/><TextViewandroid: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"><ImageViewandroid:id="@+id/headIcon"android:layout_width="50dp"android:layout_height="65dp"android:background="@mipmap/study" /><TextViewandroid: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" /><TextViewandroid: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文件
<LinearLayoutandroid:layout_width="match_parent"android:layout_height="0dp"android:layout_weight="4"><ListViewandroid: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() {Overridepublic 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"><ImageViewandroid:id="@+id/base_icon"android:src="@mipmap/study"android:layout_width="80dp"android:layout_margin="5dp"android:layout_height="80dp"/><TextViewandroid: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" /><TextViewandroid: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" /><TextViewandroid: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="这是内容" /><LinearLayoutandroid:layout_width="match_parent"android:layout_height="wrap_content"android:layout_below="@+id/base_content"android:layout_marginTop="20dp"android:orientation="horizontal"><ImageViewandroid:id="@+id/base_icon1"android:layout_width="40dp"android:layout_height="50dp"android:layout_weight="1"android:src="@mipmap/star" /><ImageViewandroid:id="@+id/base_icon2"android:layout_width="40dp"android:layout_height="50dp"android:layout_weight="1"android:src="@mipmap/star" /><ImageViewandroid: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的长度)@Overridepublic 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 布局资源转换成viewconvertView = 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() {@Overridepublic void onClick(View v) {// System.out.printf("点击了"+tN.getText());Toast.makeText(context,"你点击了"+m.getNickName(),Toast.LENGTH_SHORT).show();}});return convertView;}@Overridepublic Object getItem(int position) {return null;}@Overridepublic 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;