MultiItem扩展 仿任务面板 跨多个RecyclerView的Item拖动 支持缩小后拖动

本文是MultiItem系列的扩展文章,跨RecyclerView的Item拖动,并支持缩放的功能,主要防办公软件的面板,本功能的实现大量参考了ItemTouchHelper的源码。
MutliItem主要解决多类型RecyclerView Adapter问题,在正常使用中作到了Adapter零编码,解放了复杂的Adapter类,提升扩展性。java

源码地址

Github地址:github.com/free46000/M…,请你们多多关注,更多更新会首先在GitHub上体现,也会在第一时间在本平台发布。 git

系列文章

效果截图

跨Recycler拖动

缩放后跨Recycler拖动

用法

拖动功能

拖动功能使用比较简单,拖动功能相关流程和控制都会回调到ItemDragListener监听中。
实例化拖动辅助类,设置监听,并在dispatchTouchEvent中调用dragHelper.onTouch(ev)方法github

@Override
protected void onCreate(Bundle savedInstanceState) {
    ...
    //ItemDragHelper,须要传入外层的横向滚动的RecyclerView
    dragHelper = new ItemDragHelper(horizontalRecycler);
    //为dragHelper设置拖动监听,基本都有默认实现,可根据具体业务继承重写方法
    dragHelper.setOnItemDragListener(new OnBaseDragListener());
}

@Override
public boolean dispatchTouchEvent(MotionEvent ev) {
    //须要保证在Activity或者外层的ViewGroup中重写此方法
    //调用dragHelper.onTouch():true消耗掉事件;false则执行super
    return dragHelper.onTouch(ev) || super.dispatchTouchEvent(ev);
}复制代码

为垂直列表注册数据源,必须实现ItemData接口ide

//注册的数据源(TextDragBean)类,必须实现`ItemData`接口
baseItemAdapter.register(TextDragBean.class, new TextViewDragManager());复制代码

开启拖动功能布局

dragHelper.startDrag(viewHolder);复制代码

拖动监听,此处只复写了拖动结束回调的接口post

class OnBaseDragListener extends OnItemDragListener {

    @Override
    public void onDragFinish(RecyclerView recyclerView, int itemRecyclerPos, int itemPos) {
        super.onDragFinish(recyclerView, itemRecyclerPos, itemPos);
        String text = String.format("拖动起始第%s个列表的第%s项 结束第%s个列表的第%s项 \n\n拖动数据:%s", originalRecyclerPosition,
                originalItemPosition, itemRecyclerPos, itemPos, dragItemData);
        Toast.makeText(PanelActivity.this, text, Toast.LENGTH_SHORT).show();
    }
}复制代码

通用Item拖动控制功能

主要包括对Item的拖动、移动、切换的控制功能,数据源须要实现ItemDrag接口,这样在拖动过程当中OnItemDragListener会根据不一样的状态进行对应的控制。
固然你也能够经过OnBaseDragListener的不一样回调方法,根据业务实现定制化的控制,这里咱们看下ItemDrag接口:动画

/** * 数据源Item拖动接口,实现一些move change等定制化的通用控制 * Created by free46000 on 2017/4/3. */
public interface ItemDrag {
    /** * 是否能够在本身的Recycler中move * * @return boolean */
    boolean isCanMove();

    /** * 是否能够切换到其余Recycler * * @return boolean */
    boolean isCanChangeRecycler();

    /** * 是否能够开启拖动 * * @return boolean */
    boolean isCanDrag();
}复制代码

双击缩小功能

实例化辅助类并为辅助类设置须要的视图对象this

//实例化缩放功能辅助类
scaleHelper = new ViewScaleHelper();
//设置最外层的Content视图
scaleHelper.setContentView(contentView);
//设置横向的Recycler列表视图
scaleHelper.setHorizontalView(horizontalRecycler);复制代码

添加外层的垂直视图到辅助类,进行缩放统一管理编码

scaleHelper.addVerticalView(verticalView);复制代码

OnItemDragListener的回调中返回当前缩放级别,配合完成缩放后的拖动功能spa

class OnBaseDragListener extends OnItemDragListener {
    @Override
    public float getScale() {
        return scaleHelper.isInScaleMode() ? scaleHelper.getScale() : super.getScale();
    }
}复制代码

开启或关闭缩放功能

//开启或关闭缩放模式
scaleHelper.toggleScaleModel();
//开启缩放模式
scaleHelper.startScaleModel();
//关闭缩放模式
scaleHelper.stopScaleModel();复制代码

其余定制化用法

定制化业务主要经过复写ItemDragListener的相关方法实现,下面简单列举一些可定制的功能:

  • getScale() 缩放比例详见ViewScaleHelper#getScale()
  • Item和列表选中移动等流程控制相关方法(包含移动前的确认回调),详见源码及注释
  • getHorizontalScrollMaxSpeed getVerticalScrollMaxSpeed 最大水平垂直滚动速度
  • getHorizontalLimit getVerticalLimit 计算水平垂直滚动距离
  • calcHorizontalScrollDistance calcVerticalScrollDistance 最大水平垂直滚动速度
  • onDrawFloatView(View floatView) 浮动视图动画处理
  • getMoveLimit()两个Item是否进行move边界值

上面所介绍定制化用法并非所有,若有须要更深层次定制能够提交issues或留言

主要流程解析

备注:如下所说触摸位置都为相对屏幕位置,这样方便后续计算

生成浮动视图

被拖动Item视图设为不可见状态,浮动视图采用WindowManager + ImageView展现被拖动Item视图的Bitmap

计算横向和竖向的RecyclerView滚动

  • 大量参考了ItemTouchHelper的源码
  • 根据用户触摸位置计算是否须要滚动,和滚动的方向与距离 详见ItemDragListenercalcXXXScrollDistance() calcScrollXXXDirect()
  • 采用定时Runnable形式,保证持续的滚动
  • 滚动时调用Item位置计算方法,使得在滚动过程当中也能够更换Item位置

Item位置更换计算

  • 根据触摸位置horizontalRecycler.findChildViewUnder(x, y)找到垂直recyclerView的位置,若找到位置继续
  • 根据上一次垂直recyclerView所在的位置,判断是否为第一次选中或者是切换recyclerView的操做,此处可经过itemDragListener回调拦截这次操做的结果
  • 若是须要切换recyclerView的位置,此时须要对被拖动的Item进行remove,并在新的recyclerViewadd进去
  • 根据触摸位置recyclerView.findChildViewUnder(itemX, itemY)找到itemView的位置
  • 根据上一次itemView所在的位置,判断是否须要移动itemView位置的操做,此处可经过itemDragListener回调拦截这次操做的结果
  • 若是须要移动动itemView位置则须要把recyclerView滚动到合适的位置,防recyclerView乱跳

视图缩放

视图缩放采用的是把外层的视图还有横向列表视图扩大,并对横向列表视图进行setScaleX setScaleY的操做,而后对缩放后的视图宽度进行赋值,防止一些充满屏幕的布局,影响缩放效果,等中止缩放的时候还原便可。

总结

这个功能实现起来比较仓促,并无过多的考虑,算是一个beta版本。以上整理了用法,并对主要流程作了简单的解析,若是你们有兴趣能够结合源码理解原理,若有不明白,或者实现不够优雅的地方,欢迎你们指出。

相关文章
相关标签/搜索