AndroidApp和车机开发：RecyclerView实现触摸和拖放的功能

原创

Nimyears

修改于 2024-07-20 16:37:13

1750

修改于 2024-07-20 16:37:13

引言

在现代应用程序中，用户交互性是提供丰富用户体验的关键因素。RecyclerView作为Android中处理列表和网格布局的强大组件，支持多种交互，包括拖放排序。本文指导您如何在RecyclerView中实现拖放功能，使用户能够通过长按和拖动来重新排序列表项，用Kotlin实现

长按和拖放操作

为了为RecyclerView添加长按拖放功能，我们将通过自定义ItemTouchHelper.Callback来精确控制拖动行为，涉及重写onMove方法和getMovementFlags方法

拖动排序逻辑

onMove：此方法在拖动操作期间被调用，用于交换列表项的位置，并更新适配器的数据源。
getMovementFlags：在此方法中，我们将定义列表项可拖动的方向。

实现步骤

第一步：编写XML布局文件

首先，为列表项编写XML布局文件，如 item_type_one.xml：

//item_type_one.xml，依此类推...
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="640px"
    android:layout_height="200px"
    android:background="@color/black">
</LinearLayout>

视图布局结构如图下

第二步：创建视图适配器

创建 MyAdapter 类，继承自 RecyclerView.Adapter 实现 onCreateViewHolder 和 onBindViewHolder 方法：

import android.view.LayoutInflater
import android.view.View
import android.view.ViewGroup
import androidx.recyclerview.widget.RecyclerView
import com.nim.recyclerviewtechdemo.Item
import com.nim.recyclerviewtechdemo.R
import java.util.Collections

/**
 * @author Nimyears
 */

class MyAdapter(items: List<Item?>) : RecyclerView.Adapter<RecyclerView.ViewHolder>() {
    private val items: List<Item?> = items
    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): RecyclerView.ViewHolder {
        val view: View
        when (viewType) {
            0 -> {
                view = LayoutInflater.from(parent.context)
                    .inflate(R.layout.item_type_one, parent, false)
                return TypeOneViewHolder(view)
            }
            1 -> {
                view = LayoutInflater.from(parent.context)
                    .inflate(R.layout.item_type_two, parent, false)
                return TypeTwoViewHolder(view)
            }
            2 -> {
                view = LayoutInflater.from(parent.context)
                    .inflate(R.layout.item_type_three, parent, false)
                return TypeThreeViewHolder(view)
            }
           ....
            else -> throw IllegalArgumentException("无效视图类型")
        }
    }

    override fun onBindViewHolder(holder: RecyclerView.ViewHolder, position: Int) {
        //...
    }

    override fun getItemCount(): Int {
        return items.size
    }

    override fun getItemViewType(position: Int): Int {
        return items[position]?.type ?: 0
    }

    fun moveItem(fromPosition: Int, toPosition: Int) {
        if (fromPosition < toPosition) {
            for (i in fromPosition until toPosition) {
                Collections.swap(items, i, i + 1)
            }
        } else {
            for (i in fromPosition downTo toPosition + 1) {
                Collections.swap(items, i, i - 1)
            }
        }
        notifyItemMoved(fromPosition, toPosition)
    }

    internal class TypeOneViewHolder(itemView: View?) : RecyclerView.ViewHolder(
        itemView!!
    )

    internal class TypeTwoViewHolder(itemView: View?) : RecyclerView.ViewHolder(
        itemView!!
    )

    internal class TypeThreeViewHolder(itemView: View?) : RecyclerView.ViewHolder(
        itemView!!
    )
....
}

第三步：配置 `RecyclerView` 和适配器

在 MainActivity 中配置 RecyclerView 和适配器：

/**
 * @author Nimyears
 */
class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val items: MutableList<Item?> = ArrayList()
        for (i in 0..7) {
            items.add(Item(i))
        }

        val recyclerView = findViewById<RecyclerView>(R.id.recyclerView)
        val layoutManager = GridLayoutManager(this, 2, GridLayoutManager.HORIZONTAL, false)
        recyclerView.layoutManager = layoutManager
        val adapter = MyAdapter(items)
        recyclerView.adapter = adapter
           }
        }

第四步：实现 `moveItem` 函数

在适配器中实现 moveItem 函数，用于交换数据集中的元素位置，通知 RecyclerView 更新：

比较源位置和目标位置。
使用Collections.swap交换元素在列表中的位置。
调用notifyItemMoved通知RecyclerView元素已移动。

override fun getItemCount(): Int {
    return items.size
}

override fun getItemViewType(position: Int): Int {
    return items[position]?.type ?: 0
}
//TODO 这段代码块是重点
fun moveItem(fromPosition: Int, toPosition: Int) {
    if (fromPosition < toPosition) {
        for (i in fromPosition until toPosition) {
            Collections.swap(items, i, i + 1)
        }
    } else {
        for (i in fromPosition downTo toPosition + 1) {
            Collections.swap(items, i, i - 1)
        }
    }
    notifyItemMoved(fromPosition, toPosition)
}

第五步：创建 `ItemTouchHelper` 实例设置回调

创建 ItemTouchHelper 实例设置回调启用拖放功能：

  val itemTouchHelper = ItemTouchHelper(object : ItemTouchHelper.Callback() {
        override fun getMovementFlags(
            recyclerView: RecyclerView,
            viewHolder: RecyclerView.ViewHolder
        ): Int {
            return makeMovementFlags(
                ItemTouchHelper.UP or ItemTouchHelper.DOWN or ItemTouchHelper.LEFT or ItemTouchHelper.RIGHT,
                0
            )
        }

        override fun onMove(
            recyclerView: RecyclerView,
            viewHolder: RecyclerView.ViewHolder,
            target: RecyclerView.ViewHolder
        ): Boolean {
            val fromPosition = viewHolder.adapterPosition
            val toPosition = target.adapterPosition
            adapter.moveItem(fromPosition, toPosition)
            return true
        }

        override fun onSwiped(viewHolder: RecyclerView.ViewHolder, direction: Int) {
            //不需要编写
        }
    })

    itemTouchHelper.attachToRecyclerView(recyclerView)
}