简介

RecyclerView是一个强大的组件,用来代替ListViewGridView,可以实现数据纵向滚动以及横向滚动、瀑布流布局,提供更高效的回收和复用机制,同时也能实现管理,目前被广泛使用。

BaseRecyclerViewAdapterHelper是一个RecyclerView.Adapter的框架,能节省大量的开发时间,因为在其中集成了大部分常用需求的解决方案。

教程

导入框架

  1. build.gradle(Project)中添加JitPack

    build.gradle(Project)
    1
    2
    3
    4
    5
    6
    allprojects {
    repositories {
    ...
    maven { url 'https://jitpack.io' }
    }
    }
  2. build.gradle(Module)中添加RecyclerView依赖

    build.gradle(Module)
    1
    2
    3
    4
    5
    dependencies {
    ...
    implementation 'androidx.recyclerview:recyclerview:1.1.0'
    implementation 'com.github.CymChad:BaseRecyclerViewAdapterHelper:3.0.0-beta11'
    }

简单例子

  1. 在布局文件中添加RecyclerView组件

    activity_main.xml
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    <?xml version="1.0" encoding="utf-8"?>
    <androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">
    <androidx.recyclerview.widget.RecyclerView
    android:id="@+id/recyclerView"
    android:layout_width="0dp"
    android:layout_height="0dp"
    android:layout_marginStart="1dp"
    android:layout_marginTop="1dp"
    android:layout_marginEnd="1dp"
    android:layout_marginBottom="1dp"
    app:layout_constraintBottom_toBottomOf="parent"
    app:layout_constraintEnd_toEndOf="parent"
    app:layout_constraintStart_toStartOf="parent"
    app:layout_constraintTop_toTopOf="parent" />
    </androidx.constraintlayout.widget.ConstraintLayout>
  2. 编写条目布局文件

    recyclerview_main.xml
    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
    <?xml version="1.0" encoding="utf-8"?>
    <androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:orientation="vertical">
    <TextView
    android:id="@+id/textView"
    android:layout_width="0dp"
    android:layout_height="wrap_content"
    android:layout_marginTop="5dp"
    android:textSize="24sp"
    app:layout_constraintEnd_toEndOf="parent"
    app:layout_constraintStart_toStartOf="parent"
    app:layout_constraintTop_toTopOf="parent" />
    <Button
    android:id="@+id/button"
    android:layout_width="0dp"
    android:layout_height="wrap_content"
    android:layout_marginTop="8dp"
    app:layout_constraintEnd_toEndOf="parent"
    app:layout_constraintHorizontal_bias="0.0"
    app:layout_constraintStart_toStartOf="parent"
    app:layout_constraintTop_toBottomOf="@+id/textView" />
    </androidx.constraintlayout.widget.ConstraintLayout>
  3. 编写数据实体类

    MainAdapterData.java
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    class MainAdapterData {

    private String title;
    private String info;

    String getTitle() {
    return title;
    }
    void setTitle(String title) {
    this.title = title;
    }
    String getInfo() {
    return info;
    }
    void setInfo(String info) {
    this.info = info;
    }
    }
  4. 编写适配器

    MainAdapter.java
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    public class MainAdapter extends BaseQuickAdapter<MainAdapterData, BaseViewHolder> implements LoadMoreModule, DraggableModule {
    MainAdapter(int layoutResId, List<MainAdapterData> list) {
    super(layoutResId, list);
    }
    @Override
    protected void convert(BaseViewHolder helper, MainAdapterData item) {
    helper.setText(R.id.textView, item.getTitle())
    .setText(R.id.button, item.getInfo());
    }
    }
  5. Activity中使用适配器

    MainActivity.java
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    //定义RecyclerView
    RecyclerView recyclerView = findViewById(R.id.recyclerView);
    //创建数据
    List<MainAdapterData> list = new ArrayList<>();
    for (int i = 0; i < 20; i++) {
    MainAdapterData mainAdapterData = new MainAdapterData();
    mainAdapterData.setTitle(String.valueOf(i));
    mainAdapterData.setInfo(i + "s");
    list.add(mainAdapterData);
    }
    //创建适配器
    MainAdapter adapter = new MainAdapter(R.layout.recyclerview_main, list);
    //设置RecyclerView.布局管理
    recyclerView.setLayoutManager(new LinearLayoutManager(this));
    //设置RecyclerView.适配器
    recyclerView.setAdapter(adapter);
    }
    }
  6. 演示
    演示

空布局

  1. 编写空布局文件

    recyclerview_empty.xml
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
       <?xml version="1.0" encoding="utf-8"?>
    <androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">
    <TextView
    android:id="@+id/textView2"
    android:layout_width="0dp"
    android:layout_height="wrap_content"
    android:layout_marginTop="152dp"
    android:gravity="center"
    android:text="空"
    android:textSize="30sp"
    app:layout_constraintEnd_toEndOf="parent"
    app:layout_constraintStart_toStartOf="parent"
    app:layout_constraintTop_toTopOf="parent" />
    </androidx.constraintlayout.widget.ConstraintLayout>
  2. Activity中使用

    MainActivity.java
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    //定义RecyclerView
    RecyclerView recyclerView = findViewById(R.id.recyclerView);
    //创建适配器
    MainAdapter adapter = new MainAdapter(R.layout.recyclerview_main, null);
    //设置RecyclerView.布局管理
    recyclerView.setLayoutManager(new LinearLayoutManager(this));
    //设置RecyclerView.适配器
    recyclerView.setAdapter(adapter);
    //创建适配器.空布局
    //在setAdapter后使用 且 new MainAdapter第二个参数为null
    adapter.setEmptyView(R.layout.recyclerview_empty);
    }
    }
  3. 演示
    演示

头部与尾部

  1. 编写头部布局文件

    recyclerview_header.xml
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
       <?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:orientation="vertical">
    <TextView
    android:id="@+id/textView"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:gravity="center"
    android:text="Header"
    android:textSize="24sp" />
    </LinearLayout>
  2. 编写尾部布局文件

    recyclerview_footer.xml
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
       <?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:orientation="vertical">
    <TextView
    android:id="@+id/textView"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:gravity="center"
    android:text="Footer"
    android:textSize="24sp" />
    </LinearLayout>
  3. Activity中使用

    MainActivity.java
    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
    public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    //定义RecyclerView
    RecyclerView recyclerView = findViewById(R.id.recyclerView);
    //创建数据
    List<MainAdapterData> list = new ArrayList<>();
    for (int i = 0; i < 20; i++) {
    MainAdapterData mainAdapterData = new MainAdapterData();
    mainAdapterData.setTitle(String.valueOf(i));
    mainAdapterData.setInfo(i + "s");
    list.add(mainAdapterData);
    }
    //创建适配器
    MainAdapter adapter = new MainAdapter(R.layout.recyclerview_main, list);
    //创建适配器.头部
    //adapter.setHeaderWithEmptyEnable(true);//同时显示头部与空布局
    //adapter.setFooterWithEmptyEnable(true);//同时显示尾部与空布局
    //adapter.removeHeaderView();//删除指定头部
    //adapter.removeFooterView();//删除指定尾部
    //adapter.removeAllHeaderView();//删除所有头部
    //adapter.removeAllFooterView();//删除指定尾部
    //adapter.setHeaderViewAsFlow(true);//设置头部不占满一行
    //adapter.setFooterViewAsFlow(true);//设置尾部不占满一行
    adapter.setHeaderView(View.inflate(this, R.layout.recyclerview_header, null));//设置头部,可添加多个头部
    adapter.setFooterView(View.inflate(this, R.layout.recyclerview_footer, null));//设置尾部,可添加多个尾部
    //设置RecyclerView.布局管理
    recyclerView.setLayoutManager(new LinearLayoutManager(this));
    //设置RecyclerView.适配器
    recyclerView.setAdapter(adapter);
    }
    }
  4. 演示
    演示

动画

  1. 开启并设置动画

    1
    2
    3
    4
    adapter.setAnimationEnable(true);//开启动画-默认渐显效果类型
    adapter.setAnimationWithDefault(BaseQuickAdapter.AnimationType.AlphaIn);//设置默认动画类型,如AlphaIn、SlideInLeft、SlideInRight、SlideInBottom、ScaleIn等
    adapter.setAnimationFirstOnly(false);//设置始终显示动画
    adapter.setAdapterAnimation(new BaseAnimation());//设置自定义动画
  2. 例子

    MainActivity.java
    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
    public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    //定义RecyclerView
    RecyclerView recyclerView = findViewById(R.id.recyclerView);
    //创建数据
    List<MainAdapterData> list = new ArrayList<>();
    for (int i = 0; i < 20; i++) {
    MainAdapterData mainAdapterData = new MainAdapterData();
    mainAdapterData.setTitle(String.valueOf(i));
    mainAdapterData.setInfo(i + "s");
    list.add(mainAdapterData);
    }
    //创建适配器
    MainAdapter adapter = new MainAdapter(R.layout.recyclerview_main, list);
    adapter.setHeaderView(View.inflate(this, R.layout.recyclerview_header, null));
    adapter.setFooterView(View.inflate(this, R.layout.recyclerview_footer, null));
    //创建适配器.动画
    adapter.setAnimationEnable(true);//打开动画
    adapter.setAnimationWithDefault(BaseQuickAdapter.AnimationType.SlideInLeft);//设置动画类型
    adapter.setAnimationFirstOnly(false);//设置始终显示动画
    //设置RecyclerView.布局管理
    recyclerView.setLayoutManager(new LinearLayoutManager(this));
    //设置RecyclerView.适配器
    recyclerView.setAdapter(adapter);
    }
    }
  3. 演示
    演示

事件

条目事件

点击事件

1
2
3
4
5
6
adapter.setOnItemClickListener(new OnItemClickListener() {//监听条目的点击事件
@Override
public void onItemClick(BaseQuickAdapter adapter, View view, int position) {
Toast.makeText(MainActivity.this, "onItemClick" + position, Toast.LENGTH_SHORT).show();
}
});

长按事件

1
2
3
4
5
6
7
adapter.setOnItemLongClickListener(new OnItemLongClickListener() {//监听条目的长按事件
@Override
public boolean onItemLongClick(BaseQuickAdapter adapter, View view, int position) {
Toast.makeText(MainActivity.this, "onItemLongClick" + position, Toast.LENGTH_SHORT).show();
return true;
}
});

条目子组件事件

点击事件

1
2
3
4
5
6
7
8
9
10
11
12
adapter.addChildClickViewIds(R.id.button);//注册条目子组件的点击事件
adapter.setOnItemChildClickListener(new OnItemChildClickListener() {//监听条目子组件的点击事件
@Override
public void onItemChildClick(BaseQuickAdapter adapter, View view, int position) {
if (view.getId() == R.id.button) {
Toast.makeText(MainActivity.this, "onItemChildClick" + position, Toast.LENGTH_SHORT).show();
//获取其他条目子组件,如有设置头部则position应加头部布局数量
TextView textView = (TextView) adapter.getViewByPosition(position, R.id.textView);
Objects.requireNonNull(textView).setText("Clicked Me");
}
}
});

长按事件

1
2
3
4
5
6
7
8
9
10
adapter.addChildLongClickViewIds(R.id.button);//注册条目子组件的长按事件
adapter.setOnItemChildLongClickListener(new OnItemChildLongClickListener() {//监听条目子组件的长按事件
@Override
public boolean onItemChildLongClick(BaseQuickAdapter adapter, View view, int position) {
if (view.getId() == R.id.button) {
Toast.makeText(MainActivity.this, "onItemChildLongClick" + position, Toast.LENGTH_SHORT).show();
}
return true;
}
});

例子

  1. 代码

    MainActivity.java
    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
    public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    //定义RecyclerView
    final RecyclerView recyclerView = findViewById(R.id.recyclerView);
    //创建数据
    List<MainAdapterData> list = new ArrayList<>();
    for (int i = 0; i < 20; i++) {
    MainAdapterData mainAdapterData = new MainAdapterData();
    mainAdapterData.setTitle(String.valueOf(i));
    mainAdapterData.setInfo(i + "s");
    list.add(mainAdapterData);
    }
    //创建适配器
    final MainAdapter adapter = new MainAdapter(R.layout.recyclerview_main, list);
    //创建适配器.组件事件
    adapter.setOnItemClickListener(new OnItemClickListener() {
    @Override
    public void onItemClick(BaseQuickAdapter adapter, View view, int position) {
    Toast.makeText(MainActivity.this, "onItemClick" + position, Toast.LENGTH_SHORT).show();
    }
    });
    adapter.setOnItemLongClickListener(new OnItemLongClickListener() {
    @Override
    public boolean onItemLongClick(BaseQuickAdapter adapter, View view, int position) {
    Toast.makeText(MainActivity.this, "onItemLongClick" + position, Toast.LENGTH_SHORT).show();
    return true;
    }
    });
    //创建适配器.子组件事件
    adapter.addChildClickViewIds(R.id.button);//注册条目子组件的点击事件
    adapter.setOnItemChildClickListener(new OnItemChildClickListener() {//监听条目子组件的点击事件
    @Override
    public void onItemChildClick(BaseQuickAdapter adapter, View view, int position) {
    if (view.getId() == R.id.button) {
    Toast.makeText(MainActivity.this, "onItemChildClick" + position, Toast.LENGTH_SHORT).show();
    //获取其他子控件,如有设置头部则position应加头部布局数量
    TextView textView = (TextView) adapter.getViewByPosition(position, R.id.textView);
    Objects.requireNonNull(textView).setText("Clicked Me");
    }
    }
    });
    adapter.addChildLongClickViewIds(R.id.button);//注册条目子组件的长按事件
    adapter.setOnItemChildLongClickListener(new OnItemChildLongClickListener() {//监听条目子组件的长按事件
    @Override
    public boolean onItemChildLongClick(BaseQuickAdapter adapter, View view, int position) {
    if (view.getId() == R.id.button) {
    Toast.makeText(MainActivity.this, "onItemChildLongClick" + position, Toast.LENGTH_SHORT).show();
    }
    return true;
    }
    });
    //设置RecyclerView
    recyclerView.setLayoutManager(new LinearLayoutManager(this));
    recyclerView.setAdapter(adapter);
    }
    }
  2. 演示
    演示

上拉加载

  1. Adapter中导入LoadMoreModule

    1
    public class MainAdapter extends BaseQuickAdapter<MainAdapterData, BaseViewHolder> implements LoadMoreModule
  2. 编写代码

    MainActivity.java
    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
    public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    //定义RecyclerView
    final RecyclerView recyclerView = findViewById(R.id.recyclerView);
    //创建数据
    List<MainAdapterData> list = new ArrayList<>();
    for (int i = 0; i < 20; i++) {
    MainAdapterData mainAdapterData = new MainAdapterData();
    mainAdapterData.setTitle(String.valueOf(i));
    mainAdapterData.setInfo(i + "s");
    list.add(mainAdapterData);
    }
    //创建适配器
    final MainAdapter adapter = new MainAdapter(R.layout.recyclerview_main, list);
    //创建适配器.上拉加载
    BaseLoadMoreModule loadMore = adapter.getLoadMoreModule();
    assert loadMore != null;
    loadMore.setEnableLoadMore(true);//打开上拉加载
    loadMore.setAutoLoadMore(true);//自动加载
    loadMore.setPreLoadNumber(1);//设置滑动到倒数第几个条目时自动加载,默认为1
    loadMore.setEnableLoadMoreIfNotFullPage(true);//当数据不满一页时继续自动加载
    //loadMore.setLoadMoreView(new BaseLoadMoreView)//设置自定义加载布局
    loadMore.setOnLoadMoreListener(new OnLoadMoreListener() {//设置加载更多监听事件
    @Override
    public void onLoadMore() {
    recyclerView.postDelayed(new Runnable() {//延迟以提升用户体验
    @Override
    public void run() {
    List<MainAdapterData> lists = new ArrayList<>();
    for (int i = 0; i < 5; i++) {
    MainAdapterData mainAdapterData = new MainAdapterData();
    mainAdapterData.setTitle(String.valueOf(i));
    mainAdapterData.setInfo(i + "s");
    lists.add(mainAdapterData);
    }
    adapter.addData(lists);
    adapter.getLoadMoreModule().loadMoreComplete();
    //adapter.loadMoreEnd()//加载完毕
    //adapter.loadMoreFail()//加载失败
    }
    }, 500);
    }
    });
    //设置RecyclerView
    recyclerView.setLayoutManager(new LinearLayoutManager(this));
    recyclerView.setAdapter(adapter);
    }
    }
  3. 演示
    演示

滑动删除

  1. Adapter中导入DraggableModule

    1
    public class MainAdapter extends BaseQuickAdapter<MainAdapterData, BaseViewHolder> implements DraggableModule
  2. 编写代码

    MainActivity.java
    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
    public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    //定义RecyclerView
    final RecyclerView recyclerView = findViewById(R.id.recyclerView);
    //创建数据
    List<MainAdapterData> list = new ArrayList<>();
    for (int i = 0; i < 20; i++) {
    MainAdapterData mainAdapterData = new MainAdapterData();
    mainAdapterData.setTitle(String.valueOf(i));
    mainAdapterData.setInfo(i + "s");
    list.add(mainAdapterData);
    }
    //创建适配器
    final MainAdapter adapter = new MainAdapter(R.layout.recyclerview_main, list);
    //创建适配器.侧滑删除
    BaseDraggableModule draggableModule = adapter.getDraggableModule();
    assert draggableModule != null;
    draggableModule.setSwipeEnabled(true);//启动侧滑删除
    draggableModule.getItemTouchHelperCallback().setSwipeMoveFlags(ItemTouchHelper.START);//侧滑删除方向
    draggableModule.setOnItemSwipeListener(new OnItemSwipeListener() {//侧滑删除监听
    @Override
    public void onItemSwipeStart(RecyclerView.ViewHolder viewHolder, int pos) {
    }
    @Override
    public void clearView(RecyclerView.ViewHolder viewHolder, int pos) {
    }
    @Override
    public void onItemSwiped(RecyclerView.ViewHolder viewHolder, int pos) {
    Toast.makeText(MainActivity.this, "onItemSwipe" + viewHolder.getLayoutPosition(), Toast.LENGTH_SHORT).show();
    }
    @Override
    public void onItemSwipeMoving(Canvas canvas, RecyclerView.ViewHolder viewHolder, float dX, float dY, boolean isCurrentlyActive) {//滑动时的背景
    canvas.drawColor(Color.parseColor("#00DDB6"));
    }
    });
    //设置RecyclerView
    recyclerView.setLayoutManager(new LinearLayoutManager(this));
    recyclerView.setAdapter(adapter);
    }
    }
  3. 演示
    演示

拖拽

  1. Adapter中导入DraggableModule

    1
    public class MainAdapter extends BaseQuickAdapter<MainAdapterData, BaseViewHolder> implements DraggableModule
  2. 编写代码

    MainActivity.java
    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
    public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    //定义RecyclerView
    final RecyclerView recyclerView = findViewById(R.id.recyclerView);
    //创建数据
    List<MainAdapterData> list = new ArrayList<>();
    for (int i = 0; i < 20; i++) {
    MainAdapterData mainAdapterData = new MainAdapterData();
    mainAdapterData.setTitle(String.valueOf(i));
    mainAdapterData.setInfo(i + "s");
    list.add(mainAdapterData);
    }
    //创建适配器
    final MainAdapter adapter = new MainAdapter(R.layout.recyclerview_main, list);
    //创建适配器.拖拽
    BaseDraggableModule draggableModule = adapter.getDraggableModule();
    assert draggableModule != null;
    draggableModule.setDragEnabled(true);//启动拖拽
    draggableModule.getItemTouchHelperCallback().setDragMoveFlags(ItemTouchHelper.LEFT | ItemTouchHelper.RIGHT | ItemTouchHelper.UP | ItemTouchHelper.DOWN);//拖拽方向
    draggableModule.setOnItemDragListener(new OnItemDragListener() {//拖拽监听
    @Override
    public void onItemDragStart(RecyclerView.ViewHolder viewHolder, int pos) {
    Toast.makeText(MainActivity.this, "onItemDragBefore" + viewHolder.getLayoutPosition(), Toast.LENGTH_SHORT).show();
    }
    @Override
    public void onItemDragMoving(RecyclerView.ViewHolder source, int from, RecyclerView.ViewHolder target, int to) {
    }
    @Override
    public void onItemDragEnd(RecyclerView.ViewHolder viewHolder, int pos) {
    Toast.makeText(MainActivity.this, "onItemDragAfter" + viewHolder.getLayoutPosition(), Toast.LENGTH_SHORT).show();
    }
    });
    //设置RecyclerView
    recyclerView.setLayoutManager(new LinearLayoutManager(this));
    recyclerView.setAdapter(adapter);
    }
    }
  3. 演示
    演示

常见问题

  • Q:数据不显示?
    A:给RecyclerView设置LayoutManager
  • Q:单条目占满屏幕?
    A:将条目的布局最外层Layoutlayout_height属性设置为wrap_parent

参考资料