An open API service indexing awesome lists of open source software.

https://github.com/sunfusheng/multitype

【MultiType】可以轻松地实现RecyclerView显示多种数据类型,数据对应布局一对多、多对多、多对一,可以注册全局类型、局部类型、默认类型
https://github.com/sunfusheng/multitype

multitype recyclerview

Last synced: about 2 months ago
JSON representation

【MultiType】可以轻松地实现RecyclerView显示多种数据类型,数据对应布局一对多、多对多、多对一,可以注册全局类型、局部类型、默认类型

Awesome Lists containing this project

README

        

# MultiType [ ![Download](https://api.bintray.com/packages/sfsheng0322/maven/MultiType/images/download.svg) ](https://bintray.com/sfsheng0322/maven/MultiType/_latestVersion)

为实现RecyclerView显示多种类型数据,包括各种Headers、Footers,参考[drakeet](https://github.com/drakeet)的扛鼎之作[MultiType](https://github.com/drakeet/MultiType)后,
着重优化了一对多的显示,即一种数据类型对应多种布局的情况,例如新闻数据类型(News.class)就可能显示
文本、左图、右图、大图、多图等多种item布局,面对这种情况就要根据数据中的类型字段(你指定属性的get()方法)去区分,
这里通过Java8的特性传递方法的引用,再通过KeyGenerator执行这个方法获取数据对应的值来解决这个问题的。

该库不仅可以显示同一种数据类型对应不同的layout,还可以显示不同数据类型对应不同的layout,如果你没有
通过[MultiTypeRegistry](https://github.com/sfsheng0322/MultiType/blob/master/MultiType/src/main/java/com/sunfusheng/multitype/MultiTypeRegistry.java)全局注册或
通过[MultiTypeAdapter](https://github.com/sfsheng0322/MultiType/blob/master/MultiType/src/main/java/com/sunfusheng/multitype/MultiTypeAdapter.java)局部注册过你的数据类型,
这个库不会让应用崩掉,会返回默认的提示layout,当然你也可以注册自己的默认数据类型,具体使用参考下面。

# MultiState [ ![Download](https://api.bintray.com/packages/sfsheng0322/maven/MultiState/images/download.svg) ](https://bintray.com/sfsheng0322/maven/MultiState/_latestVersion)

MultiState 这个库为了管理请求数据的加载中、加载成功、加载失败、数据为空的情况,与MultiType配合使用更合适。

# RecyclerViewWrapper [ ![Download](https://api.bintray.com/packages/sfsheng0322/maven/RecyclerViewWrapper/images/download.svg) ](https://bintray.com/sfsheng0322/maven/RecyclerViewWrapper/_latestVersion)

RecyclerViewWrapper 这个库结合【MultiType】和【MultiState】并使用了[SmartRefreshLayout](https://github.com/scwang90/SmartRefreshLayout)这个库来统一管理各个加载状态并简单封装了下拉刷新、上拉加载更多等相关功能,欢迎下载apk体验。

## Sample预览图

![](resources/res.png)

#### Gradle配置

// MultiType
api 'com.sunfusheng:MultiType:'

// MultiState
api 'com.sunfusheng:MultiState:'

// RecyclerViewWrapper
compile 'com.sunfusheng:RecyclerViewWrapper:'

// 如果不想用库里版本的RecyclerView,可这样配置
api 'com.sunfusheng:RecyclerViewWrapper:', {
exclude group: 'com.android.support'
}

// 如果同步不下来库的话,在工程下的 build.gradle 添加:
allprojects {
repositories {
maven { url 'https://dl.bintray.com/sfsheng0322/maven' }
}
}

## MultiType的使用

#### 全局注册

```java
MultiTypeRegistry.getInstance().register(News.class, News::getType, News.TYPE_TEXT, new TextBinder());
MultiTypeRegistry.getInstance().register(News.class, News::getType, News.TYPE_BIG_IMAGE, new BigImageBinder());
MultiTypeRegistry.getInstance().register(News.class, News::getType, News.TYPE_RIGHT_IMAGE, new RightImageBinder());
MultiTypeRegistry.getInstance().register(News.class, News::getType, News.TYPE_THREE_IMAGES, new ThreeImagesBinder());
MultiTypeRegistry.getInstance().register(Music.class, new MusicBinder());
MultiTypeRegistry.getInstance().register(Video.class, new VideoBinder());
```

#### 注册默认或不支持类型

```java
MultiTypeRegistry.getInstance().registerDefaultBinder(new NonsupportBinder());
```

#### 局部注册,局部注册会覆盖全局的

```java
MultiTypeAdapter multiTypeAdapter = new MultiTypeAdapter();
multiTypeAdapter.register(News.class, News::getType, News.TYPE_TEXT, new TextBinder());
multiTypeAdapter.register(News.class, News::getType, News.TYPE_BIG_IMAGE, new BigImageBinder());
multiTypeAdapter.register(News.class, News::getType, News.TYPE_RIGHT_IMAGE, new RightImageBinder());
multiTypeAdapter.register(News.class, News::getType, News.TYPE_THREE_IMAGES, new ThreeImagesBinder());
multiTypeAdapter.register(Music.class, new MusicBinder());
multiTypeAdapter.register(Video.class, new VideoBinder());
```

#### 初始化,设置数据

```java
RecyclerView recyclerView = findViewById(R.id.recyclerView);
recyclerView.setLayoutManager(new LinearLayoutManager(this));
recyclerView.setAdapter(multiTypeAdapter);

multiTypeAdapter.setItems(@NonNull List> items);
multiTypeAdapter.notifyDataSetChanged();
```

## MultiState的使用

| 属性 | 作用 |
| :------ | :------ |
| loadingLayout | 加载中布局 |
| normalLayout | 正常显示数据的布局 |
| errorLayout | 加载失败布局 |
| emptyLayout | 数据为空布局 |
| loadingState | 初始的加载状态 |

#### xml配置

```xml

```

#### 设置加载状态

multiStateView.setLoadingState(@LoadingState int loadingState);

### [APK下载地址](https://fir.im/MultiType),去手机上体验吧^_^


### 个人微信公众号


### 请作者喝杯咖啡^_^


### 关于我

[GitHub: sunfusheng](https://github.com/sunfusheng)

[个人邮箱: [email protected]](https://mail.126.com/)

[个人博客: sunfusheng.com](http://sunfusheng.com/)

[简书主页](http://www.jianshu.com/users/88509e7e2ed1/latest_articles)

[新浪微博](http://weibo.com/u/3852192525)