RecyclerView:使用ItemTouchHelper交换Item

本文主要是解决RecyclerView上下移动切换位置时能够移出RecyclerView控件的范围,同时增加了一些开始,结束,限制移动范围的接口,开始部分是分析,伸手党请直接拉到最后

1、基础使用

新项目做的差不多了,产品也开始附加功能了,要求:为了方便客户要增加移动列表位置进行排序的功能。没问题,其实心里正在暗暗得意,早就防着你呢,这次布局使用了RecyclerView,实现排序?太简单了,直接上代码

抽象接口用于操作交换

public interface ItemMoveHelperApi { 
   /**
     * Item 切换位置
     *
     * @param fromPosition 开始位置
     * @param toPosition   结束位置
     */
    void onItemMoved(int fromPosition, int toPosition);
}

实现交换

public class ItemMoveCallBackImpl extends ItemTouchHelper.Callback {

    private ItemMoveHelperApi mHelperApi;

    public ItemMoveCallBackImpl(ItemMoveHelperApi helperApi) {
        this.mHelperApi = helperApi;
    }
    @Override
    public boolean isLongPressDragEnabled() {
        return true;
    }
    @Override
    public boolean isItemViewSwipeEnabled() {
        return false;
    }
    @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);
    }
    @Override
    public boolean onMove(RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder, RecyclerView.ViewHolder target) {
        if (mHelperApi != null) {
            mHelperApi.onItemMoved(viewHolder.getAdapterPosition(), target.getAdapterPosition());
        }
        return true;
    }
    @Override
    public void onSwiped(RecyclerView.ViewHolder viewHolder, int direction) {
    }
}

RecyclerView使用

ItemMoveCallBackImpl mMoveCallBack = new ItemMoveCallBackImpl(this);
ItemTouchHelper touchHelper = new ItemTouchHelper(mMoveCallBack);
touchHelper.attachToRecyclerView(recyclerView);

交换实现

@Override
public void onItemMoved(int fromPosition, int toPosition) {
    mAdapter.notifyItemMoved(fromPosition, toPosition);
    //数据交换,如果不写的话,滑动后会变回原来的顺序
    ......
}

2、添加开始结束接口

果然乐极生悲,虽然这个代码一点都没有问题,但是到了实际项目中发现一个尴尬的问题,RecyclerView有下拉刷新,当RecyclerView处于顶部的时候,交换和刷新会有冲突... 没办法,继续查找代码。在查找API的过程中发现了一个方法

/**
 * Called when the ViewHolder swiped or dragged by the ItemTouchHelper is changed.
 * <p/>
 * If you override this method, you should call super.
 *
 * @param viewHolder  The new ViewHolder that is being swiped or dragged. Might be null if
 *                    it is cleared.
 * @param actionState One of {@link ItemTouchHelper#ACTION_STATE_IDLE},
 *                    {@link ItemTouchHelper#ACTION_STATE_SWIPE} or
 *                    {@link ItemTouchHelper#ACTION_STATE_DRAG}.
 * @see #clearView(RecyclerView, RecyclerView.ViewHolder)
 */
public void onSelectedChanged(ViewHolder viewHolder, int actionState) {
    if (viewHolder != null) {
        sUICallback.onSelected(viewHolder.itemView);
    }
}

通过注释和自己代码试验得出结论,这个方法是在移动开始和结束的时候调用,这样一来就简单了,首先修改一下ItemMoveHelperApi 接口,新增2个方法

/**
 * 开始移动
 */
void onMoveStart();
/**
 * 停止移动
 */
void onMoveEnd();

然后在ItemMoveCallBackImpl 中重写onSelectedChanged方法

@Override
public void onSelectedChanged(RecyclerView.ViewHolder viewHolder, int actionState) {
    if (mHelperApi == null) {
        super.onSelectedChanged(viewHolder, actionState);
        return;
    }
    if (viewHolder == null) {
        mHelperApi.onMoveEnd();
    } else {
        mHelperApi.onMoveStart();
    }
    super.onSelectedChanged(viewHolder, actionState);
}

这样就能在onMoveStart中禁止下拉刷新控件,在onMoveEnd重新启动下拉刷新控件并保存当前列表的顺序,这样就不用去每次交换位置都去保存顺序了。

3、限制移动位置

果然程序员的世界和别人不一样(或者说是产品的世界和别人(程序员)的不一样?),在我看来不错的东西人家都能提出缺点(?) RecyclerView的交换移动到顶部的时候是可以移动出去的,这个要改,没办法,改吧,先上代码

@Override
public void onChildDraw(Canvas c, RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder, float dX, float dY, int actionState, boolean isCurrentlyActive) {
    dY = getLimitedDy(recyclerView, viewHolder, dY);
    super.onChildDraw(c, recyclerView, viewHolder, dX, dY, actionState, isCurrentlyActive);
}
/**
 * 根据方向和条件获取限制在RecyclerView内部的DY值
 *
 * @param recyclerView 列表
 * @param viewHolder   drag的ViewHolder
 * @param dY           限制前的DY值
 * @return 限制后的DY值
 */
private float getLimitedDy(RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder, float dY) {
    RecyclerView.LayoutManager layoutManager = recyclerView.getLayoutManager();
    if (!(layoutManager instanceof LinearLayoutManager)
            || ((LinearLayoutManager) layoutManager).getOrientation() != OrientationHelper.VERTICAL) {
        return dY;
    }
    int position = viewHolder.getLayoutPosition();
    mDragEndPosition = mDragEndPositionFlag ?
            mDragStartPosition : recyclerView.getAdapter().getItemCount() - 1;
    if (position == mDragStartPosition) {
        return dY < 0 ? 0 : dY;
    } else if (position == mDragEndPosition) {
        return dY > 0 ? 0 : dY;
    }
    return dY;
}

方法onChildDraw会在Drag的ViewHolder移动的时候使用,参数dX,dY表示当前View和相邻的ViewHolder在X,Y方向上的位移差,根据Y轴的移动方向判断下个ViewHolder是否参与交换,如果不参与,则dY返回0,ViewHolder就不会像下个位置绘制了。同时根据这个原理加入了限制移动的开始和结束位置的接口

private int mDragStartPosition; //能够拖拽的开始位置

/**
 * 设置拖拽开始位置
 *
 * @param dragStartPosition 开始位置
 */
public void setDragStartPosition(int dragStartPosition) {
    mDragStartPosition = dragStartPosition;
}

private int mDragEndPosition; //能够拖拽的结束位置
private boolean mDragEndPositionFlag; //是否设置了拖拽结束位置

/**
 * 设置拖拽结束的位置
 *
 * @param dragEndPosition 结束位置
 */
public void setDragEndPosition(int dragEndPosition) {
    mDragEndPositionFlag = true;
    mDragEndPosition = dragEndPosition;
}

一般HeaderViewFooterView是不能移动的,但是在RecyclerView是没有这个概念的,有了上面这个接口就可以将HeaderViewFooterView限制在可移动的位置之外

至此所有问题完美解决,最后附上全部代码

public interface ItemMoveHelperApi { 
   /**
     * Item 切换位置
     *
     * @param fromPosition 开始位置
     * @param toPosition   结束位置
     */
    void onItemMoved(int fromPosition, int toPosition);

   /**
    * 开始移动
    */
   void onMoveStart();

   /**
    * 停止移动
    */
   void onMoveEnd();
}
public class ItemMoveCallBackImpl extends ItemTouchHelper.Callback {

    private ItemMoveHelperApi mHelperApi;//移动API的回调接口

    private boolean mDragEnabled = true; //是否能够通过长按切换位置

    private int mDragStartPosition; //能够拖拽的开始位置

    private int mDragEndPosition; //能够拖拽的结束位置

    private boolean mDragEndPositionFlag; //是否设置了拖拽结束位置

    public ItemMoveCallBackImpl(ItemMoveHelperApi helperApi) {
        this.mHelperApi = helperApi;
    }

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

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

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

    @Override
    public boolean onMove(RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder, RecyclerView.ViewHolder target) {
        if (mHelperApi != null) {
            mHelperApi.onItemMoved(viewHolder.getAdapterPosition(), target.getAdapterPosition());
        }
        return true;
    }

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

   @Override
   public void onSelectedChanged(RecyclerView.ViewHolder viewHolder, int actionState) {
       if (mHelperApi == null) {
           super.onSelectedChanged(viewHolder, actionState);
           return;
       }
       if (viewHolder == null) {
           mHelperApi.onMoveEnd();
       } else {
           mHelperApi.onMoveStart();
       }
       super.onSelectedChanged(viewHolder, actionState);
   }

   @Override
   public void onChildDraw(Canvas c, RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder, float dX, float dY, int actionState, boolean isCurrentlyActive) {
       dY = getLimitedDy(recyclerView, viewHolder, dY);
       super.onChildDraw(c, recyclerView, viewHolder, dX, dY, actionState, isCurrentlyActive);
   }
   /**
    * 根据方向和条件获取限制在RecyclerView内部的DY值
    *
    * @param recyclerView 列表
    * @param viewHolder   drag的ViewHolder
    * @param dY           限制前的DY值
    * @return 限制后的DY值
    */
   private float getLimitedDy(RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder, float dY) {
    RecyclerView.LayoutManager layoutManager = recyclerView.getLayoutManager();
       if (!(layoutManager instanceof LinearLayoutManager)
               || ((LinearLayoutManager) layoutManager).getOrientation() != OrientationHelper.VERTICAL) {
           return dY;
       }
       int position = viewHolder.getLayoutPosition();
       mDragEndPosition = mDragEndPositionFlag ?
               mDragStartPosition : recyclerView.getAdapter().getItemCount() - 1;
       if (position == mDragStartPosition) {
           return dY < 0 ? 0 : dY;
       } else if (position == mDragEndPosition) {
           return dY > 0 ? 0 : dY;
       }
       return dY;
   }
   /**
    * 设置能否拖拽
    *
    * @param dragEnabled 拖拽标记
    */
   public void setDragEnabled(boolean dragEnabled) {
       mDragEnabled = dragEnabled;
   }
   /**
    * 设置拖拽开始位置
    *
    * @param dragStartPosition 开始位置
    */
   public void setDragStartPosition(int dragStartPosition) {
       mDragStartPosition = dragStartPosition;
   }
   /**
    * 设置拖拽结束的位置
    *
    * @param dragEndPosition 结束位置
    */
   public void setDragEndPosition(int dragEndPosition) {
       mDragEndPositionFlag = true;
       mDragEndPosition = dragEndPosition;
   }
   /**
    * 清除固定结束位置的标记
    */
   public void clearDragEndPosition() {
       mDragEndPositionFlag = false;
   }
}


最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 205,386评论 6 479
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,939评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,851评论 0 341
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,953评论 1 278
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,971评论 5 369
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,784评论 1 283
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,126评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,765评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,148评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,744评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,858评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,479评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,080评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,053评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,278评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,245评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,590评论 2 343

推荐阅读更多精彩内容