Android进阶七:RecyclerView拖动滑动之ItemTouchHelper

最新推荐文章于 2024-08-12 03:48:16 发布
最新推荐文章于 2024-08-12 03:48:16 发布
阅读量9.4k 收藏 26
点赞数 7
分类专栏： 进阶 文章标签： android

ItemTouchHelper

ItemTouchHelper是一个强大的工具，它处理好了关于在RecyclerView上添加拖动排序与滑动删除的所有事情。

它是RecyclerView.ItemDecoration的子类，也就是说它可以轻易的添加到几乎所有的LayoutManager和Adapter中。

它还可以和现有的item动画一起工作，提供受类型限制的拖放动画等等，

类介绍

主要涉及到ItemTouchHelper 和 ItemTouchHelper.Callback两个类

ItemTouchHelper主要对RecyclerView内的item的touch事件进行扩展。

ItemTouchHelper.Callback是一个抽象类，里面有一些抽象方法需要开发者去定制，包括在设置item在什么方向可以drag(拖动)和swipe(滑动)，drag需要做什么，swipe需要做什么等，重写的方法如下：

1. getMovementFlags(RecyclerView, ViewHolder) 

2. onMove(RecyclerView, ViewHolder, ViewHolder)

3. onSwiped(ViewHolder, int)

4. onSelectedChanged(RecyclerView.ViewHolder viewHolder, int actionState)

5. clearView(RecyclerView recyclerView,RecyclerView.ViewHolder viewHolder)

6. isLongPressDragEnabled()

7. isItemViewSwipeEnabled()

getMovementFlags()

这个方法是设置那些方向可以拖动和滑动RecyclerView中的item：

@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);
}

dragFlags表示拖动flag，swipeFlags表示滑动flag。

onMove()

拖动item的回调方法，在这里面实现拖动需要做的事情，比如RecyclerView里面item的顺序交换，
传入的参数是被拖动item的ViewHolder和目标ViewHolder

onSwiped()

滑动item的回调方法，在这里面实现滑动需要做的事情，比如RecyclerView里面item的顺序交换

onSelectedChanged()

在每次item的状态变成拖拽 (ACTION_STATE_DRAG) 或者 滑动 (ACTION_STATE_SWIPE)的时候被调用。这是把你的item view变成激活状态的最佳地点。

clearView()

item被放开或者动画完成的回调

isLongPressDragEnabled()

设置是否长按才进入拖动

isItemViewSwipeEnabled()

设置是否支持滑动操作

基本使用

代码见GitHub：iPaulPro

步骤：

  • 扩展ItemTouchHelper.Callback类，重写getMovementFlags()，onMove()，onSwiped()等方法，类名SimpleItemTouchHelperCallback

  • 建立RecyclerView配套的Adapter类的回调接口，Adapter类实现该接口，用于进行item删除和交换，类名ItemTouchHelperAdapter

  • 建立ViewHolder的回调接口，ViewHolder类实现该接口，用于改变item选中和放开时候的背景改变，类名ItemTouchHelperViewHolder

  • 实例化ItemTouchHelper，绑定RecyclerView

1.建立SimpleItemTouchHelperCallback类

SimpleItemTouchHelperCallback继承ItemTouchHelper.Callback抽象类，重写getMovementFlags()，onMove()，onSwiped()等方法

public class SimpleItemTouchHelperCallback extends ItemTouchHelper.Callback {
    private final ItemTouchHelperAdapter mAdapter;

    public SimpleItemTouchHelperCallback(ItemTouchHelperAdapter adapter) {
        mAdapter = adapter;
    }

    @Override
    public int getMovementFlags(RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder) {
        final int dragFlags = ItemTouchHelper.UP | ItemTouchHelper.DOWN;
        final int swipeFlags = ItemTouchHelper.START | ItemTouchHelper.END;
        return makeMovementFlags(dragFlags, swipeFlags);
    }

    @Override
    public boolean onMove(RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder, RecyclerView.ViewHolder target) {
        if (viewHolder.getItemViewType() != target.getItemViewType()) {
            return false;
        }
         mAdapter.onItemMove(viewHolder.getAdapterPosition(), target.getAdapterPosition());
         return true;

    }

    @Override
    public void onSwiped(RecyclerView.ViewHolder viewHolder, int direction) {
        mAdapter.onItemDismiss(viewHolder.getAdapterPosition());
    }

    @Override
    public boolean isLongPressDragEnabled() {
        return true;
    }

    @Override
    public boolean isItemViewSwipeEnabled() {
        return true;
    }


    @Override
    public void onSelectedChanged(RecyclerView.ViewHolder viewHolder, int actionState) {
        if (actionState != ItemTouchHelper.ACTION_STATE_IDLE) {
            ItemTouchHelperViewHolder itemViewHolder = (ItemTouchHelperViewHolder) viewHolder;
            //回调改变item的背景颜色
            itemViewHolder.onItemSelected();
        }

        super.onSelectedChanged(viewHolder, actionState);
    }

    @Override
    public void clearView(RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder) {
        super.clearView(recyclerView, viewHolder);

        ItemTouchHelperViewHolder itemViewHolder = (ItemTouchHelperViewHolder) viewHolder;
          //回调改变item的背景颜色
        itemViewHolder.onItemClear();
    }
}

2.建立ItemTouchHelperAdapter接口，Adapter类实现该接口

public interface ItemTouchHelperAdapter {

    //拖动item的回调
    void onItemMove(int fromPosition, int toPosition);
    //滑动item后删除的回调
    void onItemDismiss(int position);
}
public class RecyclerListAdapter extends RecyclerView.Adapter<RecyclerListAdapter.ItemViewHolder> implements ItemTouchHelperAdapter {
{
    ……
    //交换item
    @Override
    public void onItemMove(int fromPosition, int toPosition) {
        String prev = mItems.remove(fromPosition);
        mItems.add(toPosition > fromPosition ? toPosition - 1 : toPosition, prev);
        notifyItemMoved(fromPosition, toPosition);
    }
   //删除item
    @Override
    public void onItemDismiss(int position) {
        mItems.remove(position);
        notifyItemRemoved(position);
    }
    ……
}

回调方法的调用在步骤1的onMove()和onSwiped()方法中。

notifyItemRemoved()和 notifyItemMoved()的调用非常重要，有了它们Adapter才能知道发生了改变。

3.建立ItemTouchHelperViewHolder接口，ViewHolder类实现该接口

public interface ItemTouchHelperViewHolder {
    //item选中的时候的回调
    void onItemSelected();
    //item放开的时候的回调
    void onItemClear();
}
public class ItemViewHolder extends RecyclerView.ViewHolder implements ItemTouchHelperViewHolder
{
      ……
       //选中item，改变背景颜色
        @Override
        public void onItemSelected() {
            itemView.setBackgroundColor(Color.LTGRAY);
        }
       //放开item，改变背景颜色
        @Override
        public void onItemClear() {
            itemView.setBackgroundColor(0);
        }
}

回调方法的调用在步骤1的onSelectedChanged()和clearView()方法中。

4.实例化ItemTouchHelper，绑定RecyclerView

mRecyclerListAdapter = new RecyclerListAdapter(this);
mRecyclerView = (RecyclerView)findViewById(R.id.id_recycler);
mRecyclerView.setLayoutManager(new LinearLayoutManager(this));
mRecyclerView.setAdapter(mRecyclerListAdapter);

ItemTouchHelper.Callback callback = new SimpleItemTouchHelperCallback(mRecyclerListAdapter);
mItemTouchHelper = new ItemTouchHelper(callback);
mItemTouchHelper.attachToRecyclerView(mRecyclerView);

以上就可以实现item的拖动和滑动操作。

滑块

当设计一个支持拖拽与拖放的列表的时候，通常都会包含一个提示可以触摸拖动的东西。它对于用户发现此功能与软件的易用性都是有帮助的，
并且Material指南也推荐 在列表处于“编辑模式”的时候这样做。让我们的例子包含一个这样的滑块也相当简单。

1.layout添加滑块

<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical" android:layout_width="match_parent"
    android:layout_height="30dp"
    android:clickable="true"
    android:focusable="true"
    >
    <TextView
        android:id="@+id/id_text"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center_vertical"
        android:textColor="#000000"
        android:layout_marginLeft="16dp"
        android:textAppearance="?android:attr/textAppearanceMedium"/>
    <ImageView
        android:id="@+id/id_img"
        android:layout_width="wrap_content"
        android:layout_height="match_parent"
        android:layout_gravity="center_vertical|right"
        android:scaleType="center"
        android:src="@mipmap/ic_launcher"/>
</FrameLayout>

id_img是在item中添加的一个图标，就是该滑块，当点击到这个滑块的时候，才能进行拖动操作。

2.定义接口，用于控制ItemTouchHelper直接开始执行拖动操作

public interface OnStartDragListener {

    void onStartDrag(RecyclerView.ViewHolder viewHolder);
}

3.RecyclerListAdapter添加id_img的触摸事件

public class RecyclerListAdapter extends RecyclerView.Adapter<RecyclerListAdapter.ItemViewHolder> implements ItemTouchHelperAdapter {
    private final OnStartDragListener mOnStartDragListener;
    @Override
    public void onBindViewHolder(final RecyclerListAdapter.ItemViewHolder holder, int position) {
        holder.textView.setText(mItems.get(position));
        holder.handleView.setOnTouchListener(new View.OnTouchListener() {
            @Override
            public boolean onTouch(View view, MotionEvent motionEvent) {
                if(MotionEventCompat.getActionMasked(motionEvent) == MotionEvent.ACTION_DOWN)
                {
                    mOnStartDragListener.onStartDrag(holder);
                }
                return false;
            }
        });
    }
}

4.Activity或Fragment实现OnStartDragListener接口，调用ItemTouchHelper的startDrag立即进行拖动

public class RecyclerListFragment extends Fragment implements RecyclerListAdapter.OnDragStartListener 
{
   ……
    @Override
    public void onStartDrag(RecyclerView.ViewHolder viewHolder) {
        mItemTouchHelper.startDrag(viewHolder);
    }
    ……
}

效果：

这里写图片描述

Grid 布局

如果你想用GridLayoutManager来修改这个项目，你会发现不能正常工作。原因和解决办法都很简单：我们必须告诉ItemTouchHelper我们想支持向左拖动和向右拖动。在InSimpleItemTouchHelperCallback中，我们已经指明了：

@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);
}

要支持grid布局，唯一需要的修改是向dragFlags中添加left和 right方向。

int dragFlags = ItemTouchHelper.UP   | ItemTouchHelper.DOWN | 
              ItemTouchHelper.LEFT | ItemTouchHelper.RIGHT;

但是，对于grid而言，滑动删除不是非常自然的设计，因此你可能需要这样来去掉此功能：

@Override
public int getMovementFlags(RecyclerView recyclerView, 
        RecyclerView.ViewHolder viewHolder) {
    int dragFlags = ItemTouchHelper.UP | ItemTouchHelper.DOWN | 
                    ItemTouchHelper.LEFT | ItemTouchHelper.RIGHT;
    int swipeFlags = 0;
    return makeMovementFlags(dragFlags, swipeFlags);
}

效果：

这里写图片描述

自定义滑动动画

ItemTouchHelper.Callback 提供了非常方便的方法来控制拖拽和滑动期间的view动画。因为ItemTouchHelper其实是一个RecyclerView.ItemDecoration，我可以

用同样的方式进行view的绘制。

在后面的部分，我们将更深入的讨论这个问题，但是这里也给出一个简单的例子，重写默认的滑动动画，显示线性淡化效果。

@Override
public void onChildDraw(Canvas c, RecyclerView recyclerView, 
        ViewHolder viewHolder, float dX, float dY, 
        int actionState, boolean isCurrentlyActive) {

    if (actionState == ItemTouchHelper.ACTION_STATE_SWIPE) {
        float width = (float) viewHolder.itemView.getWidth();
        float alpha = 1.0f - Math.abs(dX) / width;
        viewHolder.itemView.setAlpha(alpha);
        viewHolder.itemView.setTranslationX(dX);    
    } else {
        super.onChildDraw(c, recyclerView, viewHolder, dX, dY, 
                actionState, isCurrentlyActive);
    }
}

dX 与 dY参数代表目前被选择view 的移动距离，其中：

•-1.0f is a full ItemTouchHelper.END to ItemTouchHelper.STARTswipe

•1.0f is a full ItemTouchHelper.START to ItemTouchHelper.END swipe

为了不漏掉我们没有处理的actionState，记住务必调用super方法，这样其他的默认动画才会运行。

逆风Lee
关注
专栏目录
AndroidX RecyclerView总结-ItemTouchHelper
chidh的博客
05-01 1609
概述 RecyclerView不仅实现在有限窗口显示大数据集，还支持对其中的item视图进行Swipe（轻扫）和Drag（拖拽）操作，这可以借助ItemTouchHelper辅助类轻松实现。 基本使用 关键代码： // 1.创建ItemTouchHelper.Callback，实现回调方法 ItemTouchHelper.Callback callback = new ItemTouchHelpe...
android之RecycleView之ItemTouchHelper 处理拖拽、滑动删除
starzhangkiss的博客
09-06 1291
android之RecycleView之ItemTouchHelper 处理拖拽、滑动删除与RecycleView和ItemTouchHelper.Callback一起使用ItemTouchHelper内部包含内部类ItemTouchHelper.Callbackpublic class ItemTouchHelper extends RecyclerView.ItemDecoration ...
【Android】实现Recyclerview的Item可以左右侧滑动的效果
每天不是在写bug就是在写bug的路上
06-14 606
Item左右滑动
RecycleView结合ItemTouchHelper实现拖动排序
chali1314的博客
02-22 734
最近项目中需要实现对某一类条目进行拖动排序功能，实现技术方案就是利用ItemTouchHelper绑定RecyclerView、ItemTouchHelper.Callback来实现UI更新，并且实现动态控制是否开启拖动功能。其中，ItemTouchHelper是Google在androidx包中添加的，其于RecyclerView配合可以比较容易地实现这个功能。3、初始化RecycleView，并绑定ItemTouchHelper。2、实现ItemTouchHelper.Callback。
Android RecycleView 拖拽
最新发布
weixin_29266679的博客
08-12 44
Android RecyclerView 拖拽实现指南 在Android开发中，RecyclerView 是一种非常常用的组件，尤其在需要显示大量数据时尤为有效。其主要优势在于高效的视图回收机制。本文将详细介绍如何实现 RecyclerView 的拖拽功能，包括代码示例及注意事项。 RecyclerView 简介 Recy...
RecyclerView ItemTouchHelper
TyearLin的专栏
09-06 897
ItemTouchHelper是一个强大的工具，它处理好了关于在RecyclerView上添加拖动排序与滑动删除的所有事情。它是RecyclerView.ItemDecoration的子类。 基本使用   1继承 ItemTouchHelper.Callback 主要方法 方法名 作用 getMovementFlags 在此方法里面我们需要构建两个flag，一个是dragFlags，表示拖动效果支持的方向，另一个是swipeFlags，表示侧滑效果支持的方向。在我们的Demo中
RecyclerView使用ItemTouchHelper
Ung8023
09-26 381
What Why How 定义Adapter用到的接口 定义拖拽回调接口 继承ItemTouchHelperCallBack并重写方法 自定义Adapter 对应的item_imagexml文件 注意点 What**ItemTouchHelper**Google 官方对Item进行拖拽和滑动的工具类Why使用ItemTouchHelper可以实现Item拖拽排序，滑动删除等操作How 效果： 1.定
RecyclerView 知识梳理(5) - ItemTouchHelper
weixin_33940102的博客
06-23 158
一、概述 ItemTouchHelper在RecyclerView的整个体系中，负责监听Item的手势操作，我们通过给它设置一个继承于ItemTouchHelper.Callback的子类，在其中处理Item的UI变化，就可以完成侧滑删除、拖动排序等操作，下面，我们分以下几部介绍： API解析 实战 采用默认动画 自定义侧滑删除动画 二、API分析 对于Item的...
使用ItemTouchHelper实现RecyclerView的拖动排序以及滑动删除.rar
07-30
使用ItemTouchHelper实现RecyclerView的拖动排序以及滑动删除.rar,太多无法一一验证是否可用，程序如果跑不起来需要自调，部分代码功能进行参考学习。
Android 滚动条 拖动,Android开发 RecyclerView实现拖动与滑动ItemTouchHelper
weixin_33592736的博客
05-26 776
前言RecyclerView依靠ItemTouchHelper，实现item的拖动与滑动功能。使用ItemTouchHelper实现上下拖动的例子首先我们需要继承重写 ItemTouchHelper.Callbackpublic class QuickReplyItemTouchCallback extendsItemTouchHelper.Callback {privateQuickReplyA...
RecyclerView配合ItemTouchHelper实现频道排序、移动
01-11
使用RecyclerView配合ItemTouchHelper实现仿今日头条的频道排序、移动,第一个位置不动,长按拖拽进入编辑模式等功能;
itemtouchhelper
09-19
使用RecyclerView和ItemTouchHelper实现拖拽移动效果.............................................................................................................................................................................................................
安卓RecyclerView通过ItemTouchHelper实现侧滑拖拽功能
02-25
源码解析，手动实现
RecyclerView进阶：使用ItemTouchHelper实现拖拽和侧滑删除效果
08-31
ItemTouchHelper是一个辅助类，专门用于为RecyclerView添加滑动删除和拖放支持。它与RecyclerView和一个回调类（Callback）一起工作，回调类定义了用户可以执行的操作类型，并在用户执行这些操作时接收事件。在实际...
RecyclerView进阶：使用ItemTouchHelper实现拖拽和侧滑删除
热门推荐
蓝天白云梦的csdn博客
01-31 3万+
有时候我们可能需要实现侧滑删除的功能，比如知乎首页的侧滑删除，又或者长按Item进行拖动与其他Item进行位置的交换，但RecyclerView没有提供现成的API供我们操作，所幸SDK提供了ItemTouchHelper这样一个工具类帮助我们快速实现以上功能。不多说别的，我们来介绍一下ItemTouchHelp的用法及自定义动画效果
android：RecyclerView交互动画（上下拖动，左右滑动删除），Android程序员必看
2401_84149694的博客
04-07 1394
总之啊，家里没矿的同学们，如果你们想以后的日子过得好一些，多想想你们的业余时间怎么安排吧；技术方面的提升肯定是重中之重，但是技术外的一些“软实力”也不能完全忽视，很多时候升职确实是因为你的技术足够强，但也与你的“软实力”密切相关在这我也分享一份大佬自己收录整理的Android学习PDF+架构视频+面试文档+源码笔记，还有高级架构技术进阶脑图、Android开发面试专题资料，高级进阶架构资料这些都是我闲暇还会反复翻阅并给下属员工学习的精品资料。
Android 炫动滑动 卡片层叠布局，仿探探、人人影视订阅界面 简单&优雅：LayoutManager+ItemTouchHelper
2401_84149592的博客
04-22 688
都说三年是程序员的一个坎，能否晋升或者提高自己的核心竞争力，这几年就十分关键。技术发展的这么快，从哪些方面开始学习，才能达到高级工程师水平，最后进阶到Android架构师/技术专家？我总结了这 5大块；我搜集整理过这几年阿里，以及腾讯，字节跳动，华为，小米等公司的面试题，把面试的要求和技术点梳理成一份大而全的“ Android架构师”面试 PDF（实际上比预期多花了不少精力），包含知识脉络 + 分支细节。Java语言与原理；大厂，小厂。Android面试先看你熟不熟悉Java语言高级UI与自定义view。
Android使用ItemTouchHelper打造可拖拽的RecyclerView
苦逼的程序猿☺
08-31 1万+
前言ItemTouchHelper是support v7包提供的处理关于在RecyclerView上添加拖动排序与滑动删除的非常强大的工具类。它是RecyclerView.ItemDecoration的子类，也就是说它可以轻易的添加到几乎所有的LayoutManager和Adapter中。下面来看一下它的基本用法，然后使用ItemTouchHelper来仿大部分新闻客户端频道的添加删除的一个实现！
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值