文章目录
-
- 一、增加单条数据
- 二、增加多条数据
- 三、完整代码示例
- 四、RecyclerView 相关资料
一、增加单条数据
增加单条数据 : 调用 RecyclerView.Adapter 的 void notifyItemInserted(int position) 方法 , 传入的参数是被插入的元素的当前索引 ;
该方法的作用是通知任何被注册的观察者 , 该 item 元素的 position 位置是被新插入的 ;
该位置之前的元素目前在 position + 1 位置 ;
int position 参数 : 最新插入的元素在数据集中的位置 ;
注意 : 调用该方法后 , 只会刷新与该位置相关的 item 元素 , 不会刷新其它元素 , 即使数据改变了 , 也不会刷新 ;
代码示例 : 在集合的开始位置插入一个元素 ;
// 在集合开始添加一个元素
names.add(0, "戴宗");
// 通知适配器新元素添加
adapter.notifyItemInserted(0);
RecyclerView.Adapter.notifyItemInserted(int position) 函数原型 : 该函数定义在 RecyclerView 的内部类 Adapter 中 ;
public class RecyclerView extends ViewGroup implements ScrollingView,
NestedScrollingChild2, NestedScrollingChild3 {
public abstract static class Adapter<VH extends ViewHolder> {
/**
* 通知任何被注册的观察者 , 该 item 元素的 position 位置是被新插入的 ;
* 该位置之前的元素目前在 position + 1 位置 ;
*
* 这是一个结构性的变化事件 ;
* 表示在数据集中的其它元素仍然被认为是最新的数据 , 这些数据不会被重新绑定 ,
* 尽管它们的位置已经发生了变化 ;
*
* @param position 最新插入的元素在新的数据集中的位置 ;
*
* @see #notifyItemRangeInserted(int, int)
*/
public final void notifyItemInserted(int position) {
mObservable.notifyItemRangeInserted(position, 1);
}
}
}
运行效果 : 动画效果是系统自带的 , 可以自己实现 ;
二、增加多条数据
增加单条数据 : 调用 RecyclerView.Adapter 的 void notifyItemRangeInserted(int positionStart, int itemCount) 方法 , 传入的参数是被插入的元素的首个索引 , 以及插入元素的个数 ;
通知任何被注册的观察者 , 从 positionStart 位置开始的 itemCount 个 item 元素是被新插入的 ;
被插入数据之前 positionStart 位置的元素目前在 positionStart + itemCount 位置 ;
参数说明 :
int positionStart 参数 : 新插入的首个元素位置 ;
int itemCount 参数 : 新插入元素的个数 ;
代码示例 : 在集合的开始位置插入三个元素 ;
// 在集合开始添加多个元素
names.add(0, "戴宗");
names.add(0, "刘唐");
names.add(0, "李逵");
// 通知适配器多个新元素添加
adapter.notifyItemRangeInserted(0, 3);
RecyclerView.Adapter.notifyItemInserted(int position) 函数原型 : 该函数定义在 RecyclerView 的内部类 Adapter 中 ;
public class RecyclerView extends ViewGroup implements ScrollingView,
NestedScrollingChild2, NestedScrollingChild3 {
public abstract static class Adapter<VH extends ViewHolder> {
/**
* 通知任何被注册的观察者 , 从 positionStart 位置开始的 itemCount 个 item 元素是被新插入的 ;
* 被插入数据之前 positionStart 位置的元素目前在 positionStart + itemCount 位置 ;
*
* 这是一个结构性的变化事件 ;
* 表示在数据集中的其它元素仍然被认为是最新的数据 , 这些数据不会被重新绑定 ,
* 尽管它们的位置已经发生了变化 ;
*
* @param positionStart 被插入的首个元素位置 ;
* @param itemCount 被插入元素个数 ;
*
* @see #notifyItemInserted(int)
*/
public final void notifyItemRangeInserted(int positionStart, int itemCount) {
mObservable.notifyItemRangeInserted(positionStart, itemCount);
}
}
}
运行效果 : 动画效果是系统自带的 , 可以自己实现 ;
三、完整代码示例
完整代码示例 仅做参考 :
package kim.hsl.recyclerview;
import android.graphics.Color;
import android.os.Bundle;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.TextView;
import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import androidx.recyclerview.widget.GridLayoutManager;
import androidx.recyclerview.widget.RecyclerView;
import androidx.recyclerview.widget.StaggeredGridLayoutManager;
import java.util.ArrayList;
public class MainActivity extends AppCompatActivity {
/**
* 数据源
*/
private ArrayList<String> names = new ArrayList<String>();
/**
* 适配器
*/
private Adapter adapter;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// 初始化数据
initData();
//1 . 从布局中获取 RecyclerView
RecyclerView recycler_view = findViewById(R.id.recycler_view);
//2 . 创建并设置布局管理器
//创建布局管理器
StaggeredGridLayoutManager layoutManager = new StaggeredGridLayoutManager(
4,
RecyclerView.VERTICAL);
//设置布局管理器
recycler_view.setLayoutManager(layoutManager);
// 设置边距
recycler_view.addItemDecoration(new ItemDecoration());
//3 . 创建并设置列表适配器
adapter = new Adapter();
recycler_view.setAdapter(adapter);
// 初始化点击事件
initClick();
}
/**
* 初始化数据
*/
private void initData(){
names.add("宋江");
names.add("卢俊义");
names.add("吴用");
names.add("公孙胜");
names.add("关胜");
names.add("林冲");
names.add("秦明");
names.add("呼延灼");
names.add("花荣");
names.add("柴进");
names.add("李应");
names.add("朱仝");
names.add("鲁智深");
names.add("武松");
names.add("董平");
names.add("张清");
names.add("杨志");
names.add("徐宁");
names.add("索超");
}
void initClick(){
// 增加单个数据
findViewById(R.id.insert_single).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
// 在集合开始添加一个元素
names.add(0, "戴宗");
// 通知适配器新元素添加
adapter.notifyItemInserted(0);
}
});
// 增加多个数据
findViewById(R.id.insert_multi).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
// 在集合开始添加多个元素
names.add(0, "戴宗");
names.add(0, "刘唐");
names.add(0, "李逵");
// 通知适配器多个新元素添加
adapter.notifyItemRangeInserted(0, 3);
}
});
// 删除单个数据
findViewById(R.id.delete_single).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
// 删除第 0 个元素
names.remove(0);
// 通知适配器
adapter.notifyItemRemoved(0);
}
});
// 删除多个数据
findViewById(R.id.delete_multi).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
// 删除第 0 ~ 2 个元素
names.remove(0);
names.remove(0);
names.remove(0);
// 通知适配器
adapter.notifyItemRangeRemoved(0, 3);
}
});
// 修改单个数据
findViewById(R.id.modify_single).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
// 替换第 0 个元素
names.set(0, "宋江江");
// 通知适配器
adapter.notifyItemChanged(0);
}
});
// 修改多个数据
findViewById(R.id.modify_multi).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
// 替换第 0, 1, 2 个元素
names.set(0, "宋江江");
names.set(1, "卢俊俊");
names.set(2, "吴用用");
// 通知适配器
adapter.notifyItemRangeChanged(0, 3);
}
});
// 移动数据
findViewById(R.id.move_single).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
// 先移除第 0 个
names.remove(0);
// 然后在第 7 个位置插入, 此时变为第 7 个元素
names.add(7, "宋江");
// 通知适配器
adapter.notifyItemMoved(0, 7);
}
});
}
/**
* RecyclerView 适配器
*/
public class Adapter extends RecyclerView.Adapter<Adapter.ViewHolder> {
@Override
public ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
View root_view = LayoutInflater.from(MainActivity.this)
.inflate(R.layout.item_recyclerview, parent, false);
return new ViewHolder(root_view);
}
@Override
public void onBindViewHolder(@NonNull ViewHolder holder, int position) {
holder.text.setText("" + names.get(position));
}
@Override
public int getItemCount() {
return names.size();
}
public class ViewHolder extends RecyclerView.ViewHolder {
TextView text;
public ViewHolder(@NonNull View itemView) {
super(itemView);
text = itemView.findViewById(R.id.text);
}
}
}
}
四、RecyclerView 相关资料
官方文档 :
使用 RecyclerView 创建动态列表 : https://developer.android.google.cn/guide/topics/ui/layout/recyclerview
高级 RecyclerView 自定义 : https://developer.android.google.cn/guide/topics/ui/layout/recyclerview-custom
RecyclerView 官方文档 : https://developer.android.google.cn/reference/androidx/recyclerview/widget/RecyclerView
RecyclerView.Adapter 官方文档 : https://developer.android.google.cn/reference/androidx/recyclerview/widget/RecyclerView.Adapter
RecyclerView.ViewHolder 官方文档 : https://developer.android.google.cn/reference/androidx/recyclerview/widget/RecyclerView.ViewHolder
RecyclerView.ItemDecoration 官方文档 : https://developer.android.google.cn/reference/androidx/recyclerview/widget/RecyclerView.ItemDecoration
代码示例 :
GitHub 源码地址 : https://github.com/han1202012/001_RecyclerView