Home

Awesome

ClassifyView Codewake

实现原理 ClassifyView包裹这一个RecyclerView,当点击这个RecyclerView会弹出一个Dialog 该Dialog的布局会传入另一个RecyclerView.想详细了解,可以查看 博客

效果如下

image image

配置依赖

Step one: Add the JitPack repository to your build file

allprojects {
		repositories {
			...
			maven { url "https://jitpack.io" }
		}
	  }

Step two: Add the dependency

    dependencies {
	        compile 'com.github.AlphaBoom:ClassifyView:$LATEST_VERSION'
	}

最新版本查看Latest release

最近更新

快速使用

  1. 继承SimpleAdapter
   public class MyAdapter extends SimpleAdapter<Bean, MyAdapter.ViewHolder> {


    public MyAdapter(List<List<Bean>> mData) {
        super(mData);
    }


    @Override
    protected ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.item,parent,false);
        return new MyAdapter.ViewHolder(view);
    }
    //convertView是缓存的View  如何使用这个convertView 参考ListView的使用步骤
    @Override
    public View getView(ViewGroup parent, View convertView, int mainPosition, int subPosition) {
    //返回的View作为每一个Item的布局
    /*布局内容自定义 例子中如下:
    <View xmlns:android="http://schemas.android.com/apk/res/android"
      android:layout_width="match_parent"
      android:layout_height="match_parent"
      android:background="@drawable/round_shape"/>
    */
       if (convertView == null) {
            convertView = LayoutInflater.from(parent.getContext()).inflate(R.layout.item_inner, parent, false);
        }
        return convertView;
    }

    @Override
    protected void onItemClick(View view, int parentIndex, int index) {
        Toast.makeText(view.getContext(),"parentIndex: "+parentIndex+"\nindex: "+index,Toast.LENGTH_SHORT).show();
    }

    static class ViewHolder extends SimpleAdapter.ViewHolder {

        public ViewHolder(View itemView) {
            super(itemView);
        }
    }
}

2.找到ClassifyView 并设置Adapter

mClassifyView = (ClassifyView) view.findViewById(R.id.classify_view);
List<List<Bean>> data = new ArrayList<>();
for(int i=0;i<30;i++){
    List<Bean> inner = new ArrayList<>();
        if(i>10) {
            int c = (int) (Math.random() * 15+1);
            for(int j=0;j<c;j++){
                inner.add(new Bean());
            }
        }else {
            inner.add(new Bean());
        }
        data.add(inner);
    }
mClassifyView.setAdapter(new MyAdapter(data));

添加拖动状态监听

设置监听

//添加监听
ClassifyView#addDragListener(DragListener)
//移除监听    
ClassifyView#removeDragListener(DragListener)
//移除所有监听
ClassifyView#removeAllDragListener()
/**
 * 是否监听移动状态信息
 * @param enable false disable true enable default true
 */
ClassifyView#enableMoveListener(boolean)   

具体监听回调

public interface DragListener {
        /**
         * 开始拖拽
         *
         * @param parent parent is ClassifyView
         * @param startX start touch x relative classify view
         * @param startY start touch y relative classify view
         * @param region start drag  region either  main or sub
         */
        void onDragStart(ViewGroup parent,View selectedView, float startX, float startY,@Region int region);

        /**
         * star drag animation end
         * @param parent
         * @param selectedView
         * @param region
         */
        void onDragStartAnimationEnd(ViewGroup parent,View selectedView,int region);

        /**
         * 拖拽结束(recover animation end)
         */
        void onDragEnd(ViewGroup parent,@Region int region);

        /**
         * 释放被拖拽的View
         */
        void onDragRelease(ViewGroup parent, float releaseX, float releaseY,@Region int region);

        /**
         * move callback by touch location
         *
         * @param touchX 触摸的X坐标
         * @param touchY 触摸的Y坐标
         */
        void onMove(ViewGroup parent, float touchX, float touchY,@Region int region);
    }

支持的自定义的属性

ClassifyView attr

属性说明
MainSpanCount主层级目录的列数
SubSpanCount次级层级目录的列数
AnimationDuration合并动画的时间
SubRatio次级目录的高度占主层级的高度比例
EdgeWidth设置宽度用于当item到边缘时判断是否触发滑动
MainPadding设置主层级容器的padding值
MainPaddingLeft
MainPaddingTop
MainPaddingRight
MainPaddingBottom
SubPadding设置次级层级容器的padding值
SubPaddingLeft
SubPaddingTop
SubPaddingRight
SubPaddingBottom
DragScaleX当item处于被拖拽状态时X轴方向缩放比例
DragScaleY当item处于被拖拽状态时Y轴方向缩放比例
DragInMergeScaleX当被拖拽的item处于可合并状态时X轴方向缩放比例
DragInMergeScaleY当被拖拽的item处于可合并状态时Y轴方向缩放比例

InsertAbleGridView(显示合并布局的View)

属性说明
RowCount行数(默认 2)
ColumnCount列数(默认 2)
RowGap横向每列中的间隙距离
ColumnGap纵向每行之间的间隙距离
OutLinePadding处于可以合并状态及非合并状态 外围框的距离
OutlineWidth外边框的宽度
OutlineColor外边框的颜色
InnerPadding当内部有多个子View 时 与周围的边距

高级自定义

如果不喜欢List<List<>>的结构可以集成PrimitiveSimpleAdapter来实现其他数据源的adapter

关于如何继承PrimitiveSimpleAdapter可以参考IReaderAdapter,如果不能满足可以考虑分别继承BaseMainAdapterBaseSubAdapter

继承ClassifyView 重写以下方法:

  1. RecyclerView getMain(Context context, AttributeSet parentAttrs) <br/>返回主层级使用的 RecyclerView。
  2. RecyclerView getSub(Context context, AttributeSet parentAttrs) 返回次级层级使用的RecyclerView
  3. View chooseTarget(View selected, List<View> swapTargets, int curX, int curY) <br/> 当拖拽的View 覆盖到子View时会通过该方法在候选View中选择一个View 为目标View 之后的交互操作都会作用于当前所选择的View 及 这个目标View<br/><font color="green">@param selected</font> 当前选择的View<br/><font color="green">@param swapTargets</font> 候选的目标View(候选的目标View 为当前选择的View 能够覆盖到所有View)<br/><font color="green">@param curX</font> 当前选中View的X轴坐标<br/><font color="green">@param curY</font> 当前选中View的Y轴坐标
  4. Drawable getDragDrawable(View view) <br/>返回用于渲染当前拖动View的显示<br/><font color="green">@param view</font> 当前选中的View<br/><font color="green">@return drawable</font>返回Drawable 用于设置拖拽View的背景
  5. 自定义次级目录的布局:
    • 自定义次级目录的Dialog:重写 Dialog createSubDialog()
    • 自定义次级目录布局:重写 View getSubContent() <br/> 注意: 默认会在返回的View中查找有Tag 为 @String/sub_container 的View作为容器 如果没有 就已返回的View作为容器来添加次级目录的RecyclerView。 可以覆盖 ViewGroup findHaveSubTagContainer(ViewGroup group) 来重写查找容器的逻辑

设置数据方式有两种方式:

  1. 使用 ClassifyView.setAdapter(BaseMainAdapter mainAdapter, BaseSubAdapter subAdapter) 用于分别设置主层级及次级层级的适配器(使用这种方式只能获取到相应状态时的回调,注意这些回调返回值的处理)
  2. 使用 setAdapter(BaseSimpleAdapter baseSimpleAdapter) 设置一个混合了主层级及次级层级的适配器,如何自定义可以参考 SimpleAdapter

主层级提供的回调

在BaseAdapter中对于mergeStart等又增加了ViewHolder形式的回调 本质是一样的。

回调方法说明是否有默认实现在BaseSubAdapter中
setDragPosition设置当前被拖拽的位置true,默认效果为隐藏被拖拽的位置
boolean canDragOnLongPress是否可以长按拖拽该Viewfalse
boolean canDropOVer是否可以在对应点放下true,默认返回true
boolean onMergeStart第一次处于可合并状态false
void onMerged合并结束false
MergeInfo onPrepareMerge当准备进行合并动画时回调,返回的MergeInfo用于做当前拖拽的View到目标位置的动画false
void onStartMergeAnimation开始合并动画的回调false
void onMergeCancel当脱离合并状态的回调false
boolean onMove当需要触发移动时的回调false
void moved移动完成的回调false
boolean canMergeItem能否进行合并操作false
int onLeaveSubRegion当从次级目录拖动出item到主层级时回调,返回int 为添加到主层级adapter的位置false
float getVelocity只对低于这个速度的才判断能否移动(需要配合getCurrentState)true
int getCurrentState判断当前处于的状态,返回三个值 Classify.STATE_NONE 无状态,Classify.STATE_MERGE 处于合并状态,Classify.STATE_MOVE 处于移动状态true
void onItemClick当item被点击时的回调false
boolean canExplodeItem用于判断当点击一个item时是否展开次级目录false

次级层级的回调

次级层级与主层级相似 没有合并的相关回调:

方法说明
void prepareExplodeItem用于准备初始化次级层级数据
boolean canDropOver对于次层级的item 能否拖动到主层级
boolean canDragOut是否可以移出次级目录到主层级
void onDialogShow次级窗口显示时的回调
void onDialogCancel次级窗口隐藏时的回调

结语

当前项目效果展现 使用SimpleAdapter