服务器之家:专注于VPS、云服务器配置技术及软件下载分享
分类导航

PHP教程|ASP.NET教程|Java教程|ASP教程|编程技术|正则表达式|C/C++|IOS|C#|Swift|Android|VB|R语言|JavaScript|易语言|vb.net|

服务器之家 - 编程语言 - Android - Android RecyclerView多类型布局卡片解决方案

Android RecyclerView多类型布局卡片解决方案

2022-10-07 16:34luokanghui Android

这篇文章主要介绍了Android RecyclerView多类型布局卡片解决方案,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧

背景

随着公司业务越来越复杂,在同一个列表中需要展示各种类型的数据。

总体结构

Android RecyclerView多类型布局卡片解决方案

  • ItemViewAdapter: 每种类型的卡片分别都是不同的ItemViewAdapter
  • ItemViewAdapterFactory: 使用ItemViewAdapterFactory根据不同数据对应不同的ItemViewAdapter
  • MultiRecyclerViewAdapter: MultiRecyclerViewAdapter就是RecylerView.Adapter,并是个ItemViewAdapterFactory。
  • 具体只要继承MultiRecyclerViewAdapter即可,实现ItemViewAdapterFactory中getViewType、onCreateItemViewAdapter两个方法
  • ContextMap: 整个Adapter共用一个ContextMap数据上下文,用于外部(例Fragment等)与ItemAdapter交互、ItemAdapter之间交互等一系列数据传递,可以解决参数层层传递的问题
  • RecyclerViewHolder: 通用RecyclerView.ViewHolder,封装根据id获取view方法getView(viewId)、获取数据上下文方法getContextMap()

使用方法

每种类型卡片Item都实现ItemViewAdapter

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
package com.lkh.multiadapter;
 
import android.support.annotation.LayoutRes;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import java.util.List;
 
/**
 * 列表单项布局与数据绑定
 * Created by luokanghui on 2017/5/24.
 */
public abstract class ItemViewAdapter<E>{
 
  /**
   * 返回列表单项View,如果View由资源layout加载而来,直接重写{@link #onGetLayoutId()}即可
   * @param parent 父view,一般为RecyclerView
   * @return 列表单项View
   */
  public View onCreateView(ViewGroup parent){
    return LayoutInflater.from(parent.getContext()).inflate(onGetLayoutId()
        , parent, false);
  }
 
  /**
   * 当RecyclerViewHolder创建成功后调用,只会调用一次
   * @param viewHolder 单项view集合
   */
  public void onCreate(RecyclerViewHolder viewHolder){
 
  }
 
  /**
   * 返回单项布局的资源id,如果重写了{@link #onCreateView(ViewGroup)},则此方法可能失效
   * @return 单项布局layout id
   */
  @LayoutRes
  protected abstract int onGetLayoutId();
 
  /**
   * 把数据与view进行绑定,滑动时都会调用
   * @param viewHolder 单项view集合
   * @param data 具体数据
   * @param position 在列表中的位置
   */
  public abstract void bindData(RecyclerViewHolder viewHolder, E data, int position);
 
  /**
   * 局部更新时调用
   * @param viewHolder 单项view集合
   * @param data 具体数据
   * @param position 在列表中的位置
   * @param payloads 局部更新标志,不会为空(isEmpty()==false)
   */
  public void bindData(RecyclerViewHolder viewHolder, E data, int position, List<Object> payloads){
 
  }
}

卡片1:

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
package com.lkh.multiadapter.sample;
 
import android.widget.TextView;
 
import com.lkh.multiadapter.ItemViewAdapter;
import com.lkh.multiadapter.R;
import com.lkh.multiadapter.RecyclerViewHolder;
 
/**
 * 卡片1实现
 * Created by luokanghui on 2019/3/18
 */
public class SampleOneItemViewAdapter extends ItemViewAdapter<DataOne> {
  @Override
  protected int onGetLayoutId() {
    //布局layout资源id
    return R.layout.item_one;
  }
 
  @Override
  public void bindData(RecyclerViewHolder viewHolder, DataOne data, int position) {
    //根据id获取view
    TextView tvContent = viewHolder.getView(R.id.tv_content);
    //数据绑定
    tvContent.setText(data.getContent());
  }
}
?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
package com.lkh.multiadapter.sample;
 
/**
 * 卡片1数据
 * Created by luokanghui on 2019/3/18
 */
public class DataOne {
  private String content;
 
  public String getContent() {
    return content;
  }
 
  public void setContent(String content) {
    this.content = content;
  }
}

item_one.xml:

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  android:layout_width="match_parent"
  android:layout_height="wrap_content"
  android:background="#eeeeee"
  android:orientation="vertical">
 
  <TextView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="卡片1"
    android:textColor="#000000" />
 
  <TextView
    android:id="@+id/tv_content"
    android:layout_width="wrap_content"
    android:layout_height="50dp"
    android:gravity="center"
    android:textColor="#000000" />
 
</LinearLayout>

卡片2

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
package com.lkh.multiadapter.sample;
 
import android.widget.TextView;
 
import com.lkh.multiadapter.ItemViewAdapter;
import com.lkh.multiadapter.R;
import com.lkh.multiadapter.RecyclerViewHolder;
 
/**
 * 卡片2实现
 * Created by luokanghui on 2019/3/18
 */
public class SampleTwoItemViewAdapter extends ItemViewAdapter<DataTwo> {
  @Override
  protected int onGetLayoutId() {
    //布局layout资源id
    return R.layout.item_two;
  }
 
  @Override
  public void bindData(RecyclerViewHolder viewHolder, DataTwo data, int position) {
    //根据id获取view
    TextView tvNum = viewHolder.getView(R.id.tv_num);
    //数据绑定
    tvNum.setText("num="+data.getNum());
  }
}
?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
package com.lkh.multiadapter.sample;
 
/**
 * 卡片2数据
 * Created by luokanghui on 2019/3/18
 */
public class DataTwo {
  private int num;
 
  public int getNum() {
    return num;
  }
 
  public void setNum(int num) {
    this.num = num;
  }
}

item_two.xml:

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  android:layout_width="match_parent"
  android:layout_height="wrap_content"
  android:background="#999999"
  android:orientation="vertical">
 
  <TextView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="卡片2"
    android:textColor="#0000ff" />
 
  <TextView
    android:id="@+id/tv_num"
    android:layout_width="wrap_content"
    android:layout_height="100dp"
    android:gravity="center"
    android:textColor="#0000ff" />
 
</LinearLayout>

总Adapter,继承MultiRecyclerViewAdapter

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
package com.lkh.multiadapter.sample;
 
import com.lkh.multiadapter.ItemViewAdapter;
import com.lkh.multiadapter.MultiRecyclerViewAdapter;
 
/**
 * 多布局adapter,根据不同data及position,使用不同ItemViewAdapter卡片
 * Created by luokanghui on 2019/3/18
 */
public class SampleMultiAdapter extends MultiRecyclerViewAdapter<Object> {
  private static final int TYPE_EMPTY = 0;//空item
  private static final int TYPE_ONE = 1;//卡片1
  private static final int TYPE_TWO = 2;//卡片2
 
  @Override
  public int getViewType(Object data, int position) {
    if (data instanceof DataOne){//卡片1
      return TYPE_ONE;
    }
 
    if (data instanceof DataTwo){//卡片2
      return TYPE_TWO;
    }
 
    return TYPE_EMPTY;//空item
  }
 
  @Override
  public ItemViewAdapter onCreateItemViewAdapter(int viewType) {
    switch (viewType){
      case TYPE_ONE://卡片1
        return new SampleOneItemViewAdapter();
      case TYPE_TWO://卡片2
        return new SampleTwoItemViewAdapter();
      default://空item
        return new EmptyItemViewAdapter();
    }
  }
}

RecyclerView中使用

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
package com.lkh.multiadapter;
 
import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.support.v7.widget.LinearLayoutManager;
import android.support.v7.widget.RecyclerView;
 
import com.lkh.multiadapter.sample.DataOne;
import com.lkh.multiadapter.sample.DataTwo;
import com.lkh.multiadapter.sample.SampleMultiAdapter;
 
import java.util.ArrayList;
import java.util.List;
 
public class MainActivity extends AppCompatActivity {
 
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
 
    RecyclerView recyclerView = findViewById(R.id.recycler_view);
    recyclerView.setLayoutManager(new LinearLayoutManager(this));
 
    SampleMultiAdapter adapter = new SampleMultiAdapter();
 
    //设置数据
    adapter.setData(generateData());
 
    //设置adapter
    recyclerView.setAdapter(adapter);
 
  }
 
  //造测试数据
  private List<Object> generateData(){
    List<Object> list = new ArrayList<>();
    for (int i=0; i<20; i++){
      DataOne dataOne = new DataOne();
      dataOne.setContent("这是卡片1数据:"+i);
      list.add(dataOne);
 
      DataTwo dataTwo = new DataTwo();
      dataTwo.setNum(i);
      list.add(dataTwo);
    }
    return list;
  }
}

activity_main.xml:

?
1
2
3
4
5
6
7
8
9
10
11
12
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  android:orientation="vertical">
 
  <android.support.v7.widget.RecyclerView
    android:id="@+id/recycler_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>
 
</LinearLayout>

运行效果如下:

Android RecyclerView多类型布局卡片解决方案

总的来说,实现一个多类型布局列表只需要写多个不同卡片ItemViewAdapter、继承MultiRecyclerViewAdapter用来控制不同数据使用不同ItemViewAdapter,新增一个卡片只需要新增一个ItemViewAdapter,在MultiRecyclerViewAdapter新加一项即可,不会影响其它卡片使用,而且ItemViewAdapter完全独立,可以很好的复用。

核心代码

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
package com.lkh.multiadapter;
 
import android.support.v7.widget.RecyclerView;
import android.view.ViewGroup;
 
import java.util.List;
 
/**
 * 多种布局adapter
 * Created by luokanghui on 2017/5/24.
 */
 
public abstract class MultiRecyclerViewAdapter<E> extends RecyclerView.Adapter<RecyclerViewHolder> implements ItemViewAdapterFactory<E> {
  public static final int NO_TYPE = -1;
 
  private List<E> dataList;
 
  protected final MapData mMapData = new MapData();
 
  public MultiRecyclerViewAdapter setData(List<E> list) {
    this.dataList = list;
    return this;
  }
 
  @Override
  public RecyclerViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
    ItemViewAdapter itemViewModule = onCreateItemViewAdapter(viewType);
    RecyclerViewHolder recyclerViewHolder = new RecyclerViewHolder(itemViewModule.onCreateView(parent), itemViewModule, this, getContextMap());
    itemViewModule.onCreate(recyclerViewHolder);
    return recyclerViewHolder;
  }
 
  @Override
  public void onBindViewHolder(RecyclerViewHolder holder, int position) {
    if (checkItems(position)) {
      return;
    }
    holder.itemViewAdapter.bindData(holder, dataList.get(position), position);
  }
 
  @Override
  public void onBindViewHolder(RecyclerViewHolder holder, int position, List<Object> payloads) {
    if (checkItems(position)) {
      return;
    }
    if (payloads.isEmpty()) {
      super.onBindViewHolder(holder, position, payloads);
    } else {
      holder.itemViewAdapter.bindData(holder, dataList.get(position), position, payloads);
    }
  }
 
  @Override
  public int getItemViewType(int position) {
    if (checkItems(position)) {
      return NO_TYPE;
    }
    return getViewType(dataList.get(position), position);
  }
 
  @Override
  public int getItemCount() {
    return dataList == null ? 0 : dataList.size();
  }
 
  /**
   * true表示没通过
   */
  private boolean checkItems(int position) {
    return dataList == null || position < 0 || position >= dataList.size();
  }
 
  @Override
  public MapData getContextMap() {
    return mMapData;
  }
}
?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
package com.lkh.multiadapter;
/**
 * 多布局ItemViewAdapter创建者
 * Created by luokanghui on 2017/5/24.
 */
public interface ItemViewAdapterFactory<E> {
 
  /**
   * 返回ItemViewAdapter的类型
   * 建议根据data的数据类型判断不同的viewType
   * @param data 具体数据
   * @param position 在列表中的位置
   * @return 类型
   */
  int getViewType(E data, int position);
 
  /**
   * 根据不同的viewType返回不同的ItemViewAdapter
   * @param viewType 类型
   * @return ItemViewAdapter
   */
  ItemViewAdapter<? extends E> onCreateItemViewAdapter(int viewType);
 
 
  /**
   * 上下文数据
   * @return
   */
  MapData getContextMap();
}
?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
package com.lkh.multiadapter;
 
import android.support.v7.widget.RecyclerView;
import android.util.SparseArray;
import android.view.View;
 
 
/**
 * ViewHolder基类
 */
public final class RecyclerViewHolder extends RecyclerView.ViewHolder {
 
  private final SparseArray<View> views;
  ItemViewAdapter itemViewAdapter;
  private final RecyclerView.Adapter adapter;
  private final MapData mMapData ;
 
 
  public RecyclerViewHolder(View itemView, ItemViewAdapter itemViewAdapter, RecyclerView.Adapter adapter, MapData mapData) {
    super(itemView);
    this.views = new SparseArray<>();
    this.itemViewAdapter = itemViewAdapter;
    this.adapter = adapter;
    this.mMapData = mapData;
  }
 
  /**
   * 根据id获取view,如果缓存中存在,直接使用缓存中的,避免重复执行findViewById
   */
  @SuppressWarnings("unchecked")
  public <T extends View> T getView(int viewId) {
    View view = views.get(viewId);
    if (view == null) {
      view = itemView.findViewById(viewId);
      views.put(viewId, view);
    }
    return (T) view;
  }
 
  public RecyclerView.Adapter getAdapter(){
    return adapter;
  }
 
  /**
   * 获取数据上下文
   */
  public MapData getContextMap(){
    return mMapData;
  }
}
?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
package com.lkh.multiadapter;
 
import android.support.annotation.LayoutRes;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
 
import java.util.List;
 
/**
 * 列表单项布局与数据绑定
 * Created by luokanghui on 2017/5/24.
 */
 
public abstract class ItemViewAdapter<E>{
 
  /**
   * 返回列表单项View,如果View由资源layout加载而来,直接重写{@link #onGetLayoutId()}即可
   * @param parent 父view,一般为RecyclerView
   * @return 列表单项View
   */
  public View onCreateView(ViewGroup parent){
    return LayoutInflater.from(parent.getContext()).inflate(onGetLayoutId()
        , parent, false);
  }
 
  /**
   * 当RecyclerViewHolder创建成功后调用,只会调用一次
   * @param viewHolder 单项view集合
   */
  public void onCreate(RecyclerViewHolder viewHolder){
 
  }
 
  /**
   * 返回单项布局的资源id,如果重写了{@link #onCreateView(ViewGroup)},则此方法可能失效
   * @return 单项布局layout id
   */
  @LayoutRes
  protected abstract int onGetLayoutId();
 
  /**
   * 把数据与view进行绑定,滑动时都会调用
   * @param viewHolder 单项view集合
   * @param data 具体数据
   * @param position 在列表中的位置
   */
  public abstract void bindData(RecyclerViewHolder viewHolder, E data, int position);
 
  /**
   * 局部更新时调用
   * @param viewHolder 单项view集合
   * @param data 具体数据
   * @param position 在列表中的位置
   * @param payloads 局部更新标志,不会为空(isEmpty()==false)
   */
  public void bindData(RecyclerViewHolder viewHolder, E data, int position, List<Object> payloads){
 
  }
}

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持服务器之家。

原文链接:https://juejin.im/post/5c8f01f8e51d456bcb58d3af

延伸 · 阅读

精彩推荐