当前位置：首页 > news >正文

Android 中解决 RecyclerView 和子控件之间的滑动冲突问题

news 来源：原创 2025/4/24 9:40:38

一、简述滑动冲突问题

在 Android 开发中，RecyclerView 和其子控件之间的滑动冲突是一个常见的问题。这种冲突通常发生在 RecyclerView 的子项本身也支持滑动操作时，例如子项是一个 ProgressBar、WebView 或其他自定义的滑动视图。当用户在子控件上滑动时，可能会触发 RecyclerView 的滑动，从而导致子控件滑动异常。

二、解决方案

requestDisallowInterceptTouchEvent 是 Android 中一个非常重要的方法，用于解决嵌套滑动（Nested Scrolling）或滑动冲突问题。它允许子视图（如 ScrollView、WebView 等）告诉父视图（如 RecyclerView、ViewPager 等）不要拦截当前的触摸事件，从而确保子视图能够正确处理这些事件。
当调用 requestDisallowInterceptTouchEvent(true) 时，父视图的 onInterceptTouchEvent 方法将不会拦截当前的触摸事件。这意味着触摸事件会直接传递给子视图，而不是被父视图处理。

三、示例（RecyclerView 和子控件 ProgressBar）

假设你有一个 RecyclerView，其中的每个子项包含一个可滑动的 ProgressBar 横向进度条。如果没有调用 requestDisallowInterceptTouchEvent(true)，当用户在 ProgressBar 上滑动时，RecyclerView 可能会拦截这些事件，导致 ProgressBar 无法正常滑动。通过在 ProgressBar 的 onTouchEvent 中调用 requestDisallowInterceptTouchEvent(true)，可以确保 ProgressBar 能够正常处理滑动事件。

1、子项布局文件 item_recycleview.xml

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"android:layout_width="wrap_content"android:layout_height="match_parent"xmlns:app="http://schemas.android.com/apk/res-auto"android:padding="20dp"><ProgressBarandroid:id="@+id/progress_bar"android:layout_width="100dp"android:layout_height="match_parent"app:layout_constraintLeft_toLeftOf="parent"app:layout_constraintRight_toRightOf="parent"app:layout_constraintTop_toTopOf="parent"app:layout_constraintBottom_toBottomOf="parent"style="?android:attr/progressBarStyleHorizontal"android:max="100"android:progress="50"/></androidx.constraintlayout.widget.ConstraintLayout>

2、适配器类 CustomAdapter.kt

在子控件的 onTouchEvent 方法中根据触摸事件类型来调用 requestDisallowInterceptTouchEvent 方法：

在触摸事件开始时（MotionEvent.ACTION_DOWN），调用 requestDisallowInterceptTouchEvent(true)，通知父控件不要拦截事件。
在触摸事件结束时（ MotionEvent.ACTION_UP 或 MotionEvent.ACTION_CANCEL），调用 requestDisallowInterceptTouchEvent(false)，允许父控件重新拦截触摸事件。

package com.example.helloworldimport android.annotation.SuppressLint
import android.view.LayoutInflater
import android.view.MotionEvent
import android.view.View
import android.view.ViewGroup
import android.widget.ProgressBar
import androidx.recyclerview.widget.RecyclerViewclass CustomAdapter: RecyclerView.Adapter<CustomAdapter.ViewHolder>() {@SuppressLint("ClickableViewAccessibility")class ViewHolder(itemView: View): RecyclerView.ViewHolder(itemView) {private val progressBar: ProgressBar = itemView.findViewById(R.id.progress_bar)init {var lastX = 0fprogressBar.setOnTouchListener { view, motionEvent ->when (motionEvent.action) {MotionEvent.ACTION_DOWN -> {// 当触摸事件发生时，通知父视图不要拦截触摸事件progressBar.parent.requestDisallowInterceptTouchEvent(true)}MotionEvent.ACTION_UP -> {// 当触摸事件发生时，通知父视图可以拦截触摸事件progressBar.parent.requestDisallowInterceptTouchEvent(false)}MotionEvent.ACTION_MOVE -> {if (motionEvent.x > lastX) {progressBar.progress += 2} else {progressBar.progress -= 2}lastX = motionEvent.x}}true}}}override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ViewHolder {val view = LayoutInflater.from(parent.context).inflate(R.layout.item_recycleview, parent, false)return ViewHolder(view)}override fun getItemCount(): Int {return 5}override fun onBindViewHolder(holder: ViewHolder, position: Int) {}
}

3、Activity 的布局文件 activity_scroll_conflict.xml

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"android:layout_width="match_parent"android:layout_height="match_parent"xmlns:app="http://schemas.android.com/apk/res-auto"><androidx.recyclerview.widget.RecyclerViewandroid:id="@+id/recycler_view"android:layout_width="300dp"android:layout_height="100dp"app:layout_constraintLeft_toLeftOf="parent"app:layout_constraintTop_toTopOf="parent"android:layout_marginTop="20dp"android:layout_marginStart="20dp"/></androidx.constraintlayout.widget.ConstraintLayout>

4、ScrollConflictActivity.kt 文件

package com.example.helloworldimport android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import androidx.recyclerview.widget.LinearLayoutManager
import com.example.helloworld.databinding.ActivityScrollConflictBindingclass ScrollConflictActivity: AppCompatActivity() {private lateinit var _binding: ActivityScrollConflictBindingoverride fun onCreate(savedInstanceState: Bundle?) {super.onCreate(savedInstanceState)_binding = ActivityScrollConflictBinding.inflate(layoutInflater)setContentView(_binding.root)_binding.recyclerView.adapter = CustomAdapter()_binding.recyclerView.layoutManager = LinearLayoutManager(this, LinearLayoutManager.HORIZONTAL, false)}
}

四、其他注意事项

性能考虑：频繁调用 requestDisallowInterceptTouchEvent 可能会影响性能，尤其是在复杂的布局中，建议仅在必要时调用此方法。
嵌套滚动支持：如果子控件支持嵌套滚动（如 NestedScrollView），可以使用 NestedScrollingParent 和 NestedScrollingChild 接口来实现更复杂的嵌套滚动逻辑。