>RecyclerView作為Android最常用的控件,受益群體幾乎是所有Android開發者,希望更多開發者能夠一起來維護這個項目,把這個項目做得更好,幫助更多人。**Star我的項目可加Q群558178792,申請的時候把GitHub的賬號名字備注上否則不予通過,謝謝配合。**中國有句古話叫“授人以魚不如授人以漁”,不僅僅提供使用,還寫了如何實現的原理:
- 「[RecyclerView.Adapter優化了嗎?](http://blog.csdn.net/cym492224103/article/details/51113321)」
- 「[BaseRecyclerAdapter之添加動畫](http://blog.csdn.net/cym492224103/article/details/51150108)」
- 「[BaseRecyclerAdapter之添加不同布局(頭部尾部)](http://blog.csdn.net/cym492224103/article/details/51214362)」
- 「[BaseRecyclerAdapter之添加不同布局(優化篇)](http://blog.csdn.net/cym492224103/article/details/51222414)」
# [BaseRecyclerViewAdapterHelper](https://github.com/CymChad/BaseRecyclerViewAdapterHelper)
一個強大并且靈活的RecyclerViewAdapter,歡迎使用。(喜歡的可以**Star**一下)
#它能做什么?([下載 apk](https://github.com/CymChad/BaseRecyclerViewAdapterHelper/raw/master/demo_res/demo.apk))
- **優化Adapter代碼(減少百分之70%代碼)**
- **添加點擊item點擊、長按事件、以及item子控件的點擊事件**
- **添加加載動畫(一行代碼輕松切換5種默認動畫)**
- **添加頭部、尾部、下拉刷新、上拉加載(感覺又回到ListView時代)**
- **添加分組(隨心定義分組頭部)**
- **自定義不同的item類型(簡單配置、無需重寫額外方法)**
- **設置空布局(比Listview的setEmptyView還要好用!)**

#如何使用它?
先在 build.gradle 的 repositories 添加:
```
allprojects {
repositories {
...
maven { url "https://jitpack.io" }
}
}
```
然后在dependencies添加:
```
dependencies {
compile 'com.github.CymChad:BaseRecyclerViewAdapterHelper:v1.6.6'
}
```
#如何使用它來創建Adapter?
```
public class QuickAdapter extends BaseQuickAdapter<Status> {
public QuickAdapter(Context context) {
super(context, R.layout.tweet, DataServer.getSampleData());
}
@Override
protected void convert(BaseViewHolder helper, Status item) {
helper.setText(R.id.tweetName, item.getUserName())
.setText(R.id.tweetText, item.getText())
.setText(R.id.tweetDate, item.getCreatedAt())
.setImageUrl(R.id.tweetAvatar, item.getUserAvatar())
.setVisible(R.id.tweetRT, item.isRetweet())
.linkify(R.id.tweetText);
}
}
```
**這么復雜的布局只需要15行代碼即可!**
#如何添加item點擊事件
```
mQuickAdapter.setOnRecyclerViewItemClickListener(new BaseQuickAdapter.OnRecyclerViewItemClickListener() {
@Override
public void onItemClick(View view, int position) {
//..
}
});
```
#新增添加子布局多個控件的點擊事件
Adapter
```
protected void convert(BaseViewHolder helper, Status item) {
helper.setOnClickListener(R.id.tweetAvatar, new OnItemChildClickListener())
.setOnClickListener(R.id.tweetName, new OnItemChildClickListener());
}
```
Activity
```
mQuickAdapter.setOnRecyclerViewItemChildClickListener(new BaseQuickAdapter.OnRecyclerViewItemChildClickListener() {
@Override
public void onItemChildClick(BaseQuickAdapter adapter, View view, int position) {
String content = null;
Status status = (Status) adapter.getItem(position);
switch (view.getId()) {
case R.id.tweetAvatar:
content = "img:" + status.getUserAvatar();
break;
case R.id.tweetName:
content = "name:" + status.getUserName();
break;
}
Toast.makeText(AnimationUseActivity.this, content, Toast.LENGTH_LONG).show();
}
});
```
#如何使用它添加動畫?
```
// 一行代碼搞定(默認為漸顯效果)
quickAdapter.openLoadAnimation();
```
不喜歡漸顯動畫可以這樣更換
```
// 默認提供5種方法(漸顯、縮放、從下到上,從左到右、從右到左)
quickAdapter.openLoadAnimation(BaseQuickAdapter.ALPHAIN);
```
還是沒你喜歡的,你可以自定義
```
// 自定義動畫如此輕松
quickAdapter.openLoadAnimation(new BaseAnimation() {
@Override
public Animator[] getAnimators(View view) {
return new Animator[]{
ObjectAnimator.ofFloat(view, "scaleY", 1, 1.1f, 1),
ObjectAnimator.ofFloat(view, "scaleX", 1, 1.1f, 1)
};
}
});
```
#使用它添加頭部添加尾部
```
mQuickAdapter.addHeaderView(getView());
mQuickAdapter.addFooterView(getView());
```
#使用它加載更多
```
mQuickAdapter.setOnLoadMoreListener(PAGE_SIZE, new BaseQuickAdapter.RequestLoadMoreListener() {
@Override
public void onLoadMoreRequested() {
if (mCurrentCounter >= TOTAL_COUNTER) {
mRecyclerView.post(new Runnable() {
@Override
public void run() {
mQuickAdapter.isNextLoad(false);
}
});
} else {
// reqData
mCurrentCounter = mQuickAdapter.getItemCount();
mQuickAdapter.isNextLoad(true);
}
}
});
```
#使用分組
```
public class SectionAdapter extends BaseSectionQuickAdapter<MySection> {
public SectionAdapter(Context context, int layoutResId, int sectionHeadResId, List data) {
super(context, layoutResId, sectionHeadResId, data);
}
@Override
protected void convert(BaseViewHolder helper, MySection item) {
helper.setImageUrl(R.id.iv, (String) item.t);
}
@Override
protected void convertHead(BaseViewHolder helper,final MySection item) {
helper.setText(R.id.header, item.header);
if(!item.isMroe)helper.setVisible(R.id.more,false);
else
helper.setOnClickListener(R.id.more, new View.OnClickListener() {
@Override
public void onClick(View v) {
Toast.makeText(context,item.header+"more..",Toast.LENGTH_LONG).show();
}
});
}
```
#如何添加多種類型item?
```
public class MultipleItemQuickAdapter extends BaseMultiItemQuickAdapter<MultipleItem> {
public MultipleItemQuickAdapter(Context context, List data) {
super(context, data);
addItmeType(MultipleItem.TEXT, R.layout.text_view);
addItmeType(MultipleItem.IMG, R.layout.image_view);
}
@Override
protected void convert(BaseViewHolder helper, MultipleItem item) {
switch (helper.getItemViewType()) {
case MultipleItem.TEXT:
helper.setImageUrl(R.id.tv, item.getContent());
break;
case MultipleItem.IMG:
helper.setImageUrl(R.id.iv, item.getContent());
break;
}
}
}
```
#使用setEmptyView
```
mQuickAdapter.setEmptyView(getView());
```
>**持續更新!,所以推薦Star項目 [\[源碼地址\]](https://github.com/CymChad/BaseRecyclerViewAdapterHelper)**
#感謝
[JoanZapata / base-adapter-helper](https://github.com/JoanZapata/base-adapter-helper)