Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/AlphaBoom/ClassifyView
No longer maintained
https://github.com/AlphaBoom/ClassifyView
Last synced: 3 months ago
JSON representation
No longer maintained
- Host: GitHub
- URL: https://github.com/AlphaBoom/ClassifyView
- Owner: AlphaBoom
- License: apache-2.0
- Created: 2017-08-07T12:30:58.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2019-06-21T17:28:32.000Z (over 5 years ago)
- Last Synced: 2024-06-16T02:43:05.364Z (5 months ago)
- Language: Java
- Homepage:
- Size: 19.1 MB
- Stars: 235
- Watchers: 8
- Forks: 57
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-github-android-ui - ClassifyView - 拖拽合并的RecyclerView (Sort&Drag)
README
# ClassifyView [](https://jitpack.io/#AlphaBoom/ClassifyView)[](https://www.codewake.com/p/classifyview)
实现原理 ClassifyView包裹这一个RecyclerView，当点击这个RecyclerView会弹出一个Dialog 该Dialog的布局会传入另一个RecyclerView.想详细了解，~可以查看 [博客](http://www.jianshu.com/p/a51a93366406)~
# 效果如下
# 配置依赖
**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](https://github.com/AlphaBoom/ClassifyView/releases)
# 最近更新
- [x] 关于仿照IReader的效果需要对原库做自定义的部分都已经更新在Sample
- [x] 在adapter中增加了拖拽开始及拖拽开始完成和次级目录弹出的回调
- [x] 增加拖拽item的可在拖拽时放大及可合并时缩小的设置
- [x] 在拖拽开始时添加动画，效果更自然
- [x] 添加了一个自定义的例子，效果大致仿IReader的书架
# 快速使用
1. 继承SimpleAdapter
```java
public class MyAdapter extends SimpleAdapter {
public MyAdapter(List> 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的布局
/*布局内容自定义 例子中如下：
*/
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
```java
mClassifyView = (ClassifyView) view.findViewById(R.id.classify_view);
List> data = new ArrayList<>();
for(int i=0;i<30;i++){
List inner = new ArrayList<>();
if(i>10) {
int c = (int) (Math.random() * 15+1);
for(int j=0;j>`的结构可以集成PrimitiveSimpleAdapter来实现其他数据源的adapter
关于如何继承PrimitiveSimpleAdapter可以参考[IReaderAdapter](https://github.com/AlphaBoom/ClassifyView/blob/master/app/src/main/java/com/anarchy/classifyview/sample/ireader/IReaderAdapter.java),如果不能满足可以考虑分别继承[BaseMainAdapter](https://github.com/AlphaBoom/ClassifyView/blob/master/classify/src/main/java/com/anarchy/classify/adapter/BaseMainAdapter.java)及[BaseSubAdapter](https://github.com/AlphaBoom/ClassifyView/blob/master/classify/src/main/java/com/anarchy/classify/adapter/BaseSubAdapter.java)
## 继承ClassifyView 重写以下方法：
1. **RecyclerView getMain(Context context, AttributeSet parentAttrs)**
返回主层级使用的 RecyclerView。
2. **RecyclerView getSub(Context context, AttributeSet parentAttrs)** 返回次级层级使用的RecyclerView
3. **View chooseTarget(View selected, List swapTargets, int curX, int curY)**
当拖拽的View 覆盖到子View时会通过该方法在候选View中选择一个View 为目标View 之后的交互操作都会作用于当前所选择的View 及 这个目标View
@param selected 当前选择的View
@param swapTargets 候选的目标View(候选的目标View 为当前选择的View 能够覆盖到所有View)
@param curX 当前选中View的X轴坐标
@param curY 当前选中View的Y轴坐标
4. **Drawable getDragDrawable(View view)**
返回用于渲染当前拖动View的显示
@param view 当前选中的View
@return drawable返回Drawable 用于设置拖拽View的背景
5. 自定义次级目录的布局：
* 自定义次级目录的Dialog：重写 **Dialog createSubDialog()**
* 自定义次级目录布局：重写 **View getSubContent()**
**注意：** 默认会在返回的View中查找有Tag 为 @String/sub_container 的View作为容器 如果没有 就已返回的View作为容器来添加次级目录的RecyclerView。 可以覆盖 **ViewGroup findHaveSubTagContainer(ViewGroup group)** 来重写查找容器的逻辑
**设置数据方式有两种方式：**
1. 使用 *ClassifyView.setAdapter(BaseMainAdapter mainAdapter, BaseSubAdapter subAdapter)* 用于分别设置主层级及次级层级的适配器（使用这种方式只能获取到相应状态时的回调，注意这些回调返回值的处理）
2. 使用 *setAdapter(BaseSimpleAdapter baseSimpleAdapter)* 设置一个混合了主层级及次级层级的适配器，如何自定义可以参考 [SimpleAdapter](https://github.com/AlphaBoom/ClassifyView/blob/master/classify/src/main/java/com/anarchy/classify/simple/SimpleAdapter.java)
## 主层级提供的回调
在BaseAdapter中对于mergeStart等又增加了ViewHolder形式的回调 本质是一样的。
回调方法 | 说明 | 是否有默认实现在BaseSubAdapter中
------ | ----- | ----
setDragPosition | 设置当前被拖拽的位置 | true，默认效果为隐藏被拖拽的位置
boolean canDragOnLongPress|是否可以长按拖拽该View | false
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](https://github.com/AlphaBoom/ClassifyView/blob/master/classify/src/main/java/com/anarchy/classify/simple/SimpleAdapter.java)**