RecyclerView的拖动和滑动 第一部分 :基本的ItemTouchHelper示例
来源:互联网 发布:淘宝买aj最靠谱的店铺 编辑:程序博客网 时间:2024/05/16 14:10
英文原文:Drag and Swipe with RecyclerView
在安卓中,有许多关于如何使用RecyclerView实现“drag & drop”与swipe-to-dismiss”的教程,库和例子。即使现在已经有了新的,更优的实现方式,大多数仍然是使用老旧的View.OnDragListener以及Roman Nurik在SwipeToDismiss中所使用的方法。很少有人使用新的api,反而要么经常依赖于GestureDetectors和onInterceptTouchEvent,要么实现方式很复杂。实际上,在RecyclerView上添加拖动特性有一个非常简单的方法。这个方法只需要一个类,并且它也是Android 兼容包的一部分,它就是:
ItemTouchHelper
ItemTouchHelper是一个强大的工具,它处理好了关于在RecyclerView上添加拖动排序与滑动删除的所有事情。它是RecyclerView.ItemDecoration的子类,也就是说它可以轻易的添加到几乎所有的LayoutManager和Adapter中。它还可以和现有的item动画一起工作,提供受类型限制的拖放动画等等,
这篇文章中,我会演示一个ItemTouchHelper的简单实现,然后在这个系列文章的后面部分,我们将拓展范围,探索一些新的特性。
跳过本文
只对完整源码感兴趣?直接跳到github: Android-ItemTouchHelper-Demo。第一次提交的代码和本文的内容相对应。 在这里下载demo apk 。
设置
第一件事是RecyclerView的基本设置,修改build.gradle,添加RecyclerView的依赖。
compile
'com.android.support:recyclerview-v7:22.2.0'
ItemTouchHelper可以与几乎任意的RecyclerView.Adapter 和 LayoutManager使用,但是本文建立了几个基本的文件,可以在Gist上找到:
https://gist.github.com/iPaulPro/2216ea5e14818056cfcc
使用 ItemTouchHelper 和 ItemTouchHelper.Callback
要使用ItemTouchHelper,你需要创建一个ItemTouchHelper.Callback。这个接口可以让你监听“move”与 “swipe”事件。这里还是控制view被选中的状态以及重写默认动画的地方。如果你只是想要一个基本的实现,有一个帮助类可以使用:SimpleCallback,但是为了了解其工作机制,我们还是自己实现。
启用基本的拖动排序与滑动删除需要重写的主要回调方法是:
getMovementFlags(RecyclerView, ViewHolder)
onMove(RecyclerView, ViewHolder, ViewHolder)
onSwiped(ViewHolder, int)
我也需要两个帮助方法:
isLongPressDragEnabled()
isItemViewSwipeEnabled()
我们将一一解答上面的方法。
@Override
public int getMovementFlags(RecyclerView recyclerView,
RecyclerView.ViewHolder viewHolder) {
int dragFlags = ItemTouchHelper.UP | ItemTouchHelper.DOWN;
int swipeFlags = ItemTouchHelper.START | ItemTouchHelper.END;
return
makeMovementFlags(dragFlags, swipeFlags);
}
ItemTouchHelper可以让你轻易得到一个事件的方向。你需要重写getMovementFlags()方法来指定可以支持的拖放和滑动的方向。使用helperItemTouchHelper.makeMovementFlags(int, int)来构造返回的flag。这里我们启用了上下左右两种方向。注:上下为拖动(drag),左右为滑动(swipe)。
@Override
public boolean isLongPressDragEnabled() {
return
true
;
}
ItemTouchHelper可以用于没有滑动的拖动操作(或者反过来),你必须指明你到底要支持哪一种。要支持长按RecyclerView item进入拖动操作,你必须在isLongPressDragEnabled()方法中返回true。或者,也可以调用ItemTouchHelper.startDrag(RecyclerView.ViewHolder) 方法来开始一个拖动。这会在后面讲到。
@Override
public boolean isItemViewSwipeEnabled() {
return
true
;
}
而要在view任意位置触摸事件发生时启用滑动操作,则直接在sItemViewSwipeEnabled()中返回true就可以了。或者,你也主动调用ItemTouchHelper.startSwipe(RecyclerView.ViewHolder) 来开始滑动操作。
接下来的两个是onMove()和onSwiped(),用于通知底层数据的更新。首先我们创建一个可以将这些回调方法传递出去的接口。
public interface ItemTouchHelperAdapter {
void onItemMove(int fromPosition, int toPosition);
void onItemDismiss(int position);
}
ItemTouchHelperAdapter.java Gist
以本例来说,最简单的方法就是在我们的RecyclerListAdapter 中实现这个listener。
public class RecyclerListAdapter extends
RecyclerView.Adapter<ItemViewHolder>
implements ItemTouchHelperAdapter {
// ... code from gist
@Override
public void onItemDismiss(int position) {
mItems.remove(position);
notifyItemRemoved(position);
}
@Override
public void onItemMove(int from, int to) {
Collections.swap(mItems, from, to);
notifyItemMoved(from, to);
}
notifyItemRemoved()和 notifyItemMoved()的调用非常重要,有了它们Adapter才能知道发生了改变。同时还需要注意的是每当一个view切换到了一个新的索引时,我们都需要改变item的位置,而不是在拖动事件结束的时候。
现在我们回来创建我们的SimpleItemTouchHelperCallback,我们仍然需要重写onMove() 和 onSwiped()。
首先我们添加一个构造函数以及一个引用adapter的成员变量:
private final ItemTouchHelperAdapter mAdapter;
public SimpleItemTouchHelperCallback(
ItemTouchHelperAdapter adapter) {
mAdapter = adapter;
}
然后重写剩下的事件同时通知adapter:
@Override
public boolean onMove(RecyclerView recyclerView,
RecyclerView.ViewHolder viewHolder,
RecyclerView.ViewHolder target) {
mAdapter.onItemMove(viewHolder.getAdapterPosition(),
target.getAdapterPosition());
return
true
;
}
@Override
public void onSwiped(RecyclerView.ViewHolder viewHolder,
int direction) {
mAdapter.onItemDismiss(viewHolder.getAdapterPosition());
}
这样Callback类大致如下:
public class SimpleItemTouchHelperCallback extends ItemTouchHelper.Callback {
private final ItemTouchHelperAdapter mAdapter;
public SimpleItemTouchHelperCallback(ItemTouchHelperAdapter adapter) {
mAdapter = adapter;
}
@Override
public boolean isLongPressDragEnabled() {
return
true
;
}
@Override
public boolean isItemViewSwipeEnabled() {
return
true
;
}
@Override
public int getMovementFlags(RecyclerView recyclerView, ViewHolder viewHolder) {
int dragFlags = ItemTouchHelper.UP | ItemTouchHelper.DOWN;
int swipeFlags = ItemTouchHelper.START | ItemTouchHelper.END;
return
makeMovementFlags(dragFlags, swipeFlags);
}
@Override
public boolean onMove(RecyclerView recyclerView, ViewHolder viewHolder,
ViewHolder target) {
mAdapter.onItemMove(viewHolder.getAdapterPosition(), target.getAdapterPosition());
return
true
;
}
@Override
public void onSwiped(ViewHolder viewHolder, int direction) {
mAdapter.onItemDismiss(viewHolder.getAdapterPosition());
}
}
Callback准备好了之后,我们就可以创建我们的ItemTouchHelper并调用attachToRecyclerView(RecyclerView) 了(参见MainFragment.java):
ItemTouchHelper.Callback callback =
new
SimpleItemTouchHelperCallback(adapter);
ItemTouchHelper touchHelper =
new
ItemTouchHelper(callback);
touchHelper.attachToRecyclerView(recyclerView);
运行之后,你可以看到如下的效果:
总结
这是一个ItemTouchHelper的简单实现。但是已经阐明了在RecyclerView上实现拖动排序与滑动删除时根本不需要第三方库的。在下一部分中,我们将对被拖动或者滑动的item做更多外观上的控制。
源代码
我在github上创建了一个覆盖这个系列文章的项目:Android-ItemTouchHelper-Demo。第一次提交的代码和这部分相对应的,也有点第二部分的内容。
- RecyclerView的拖动和滑动 第一部分 :基本的ItemTouchHelper示例
- RecyclerView的拖动和滑动 第一部分 :基本的ItemTouchHelper示例
- RecyclerView的拖动和滑动 第一部分 :基本的ItemTouchHelper示例
- RecyclerView的拖动和滑动:基本的ItemTouchHelper示例(转)
- RecyclerView的拖动和滑动
- RecyclerView借助ItemTouchHelper实现拖动和滑动删除功能
- ItemTouchHelper实现RecyclerView拖动排序和滑动删除
- RecyclerView的item拖动排序效果实现和它的ItemTouchHelper详解
- Android使用ItemTouchHelper实现RecyclerView的item拖动位置交换
- RecyclerView的拖动和滑动 第二部分 :拖块,Grid以及自定义动画
- RecyclerView的拖动和滑动 第二部分 :拖块,Grid以及自定义动画
- RecyclerView的拖动和滑动 第二部分 :拖块,Grid以及自定义动画
- RecyclerView的拖动和滑动 第二部分 :拖块,Grid以及自定义动画
- ItemTouchHelper类及RecyclerView的item滑动删除和拖拽案例
- Android进阶七:RecyclerView拖动滑动之ItemTouchHelper
- RecyclerView 滑动删除与拖动的实现
- RecyclerView实现拖动和滑动
- ItemTouchHelper,让你轻松打造RecyclerView中Item的滑动删除,拖拽交换
- Thread类中的Join()
- #ifndef, #define, #endif 作用
- IDA动态调试Android的DEX文件
- Android按返回键退出程序但不销毁,程序后台运行,同QQ退出处理方式
- chenw Hibernate 缓存机制
- RecyclerView的拖动和滑动 第一部分 :基本的ItemTouchHelper示例
- 读取web.xml文件中数据的三种方法
- R语言入门
- ARM汇编编程规则
- 数据库表设计时一对一关系
- 如何将数据绑定到gridview指定列中,终于解决啦~
- 用QProcess实现父子进程的双向交互
- 使用ZooKeeper实现配置同步
- QT中使用QProcess启用外部程序和关闭外部程序