设置clickable=true后Persistent BottomSheet无法拖动的问题

问题场景 #

使用Persistent BottomSheet时遇到以下冲突：

• BottomSheet布局代码：

<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:id="@+id/bs"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@drawable/bottom_sheet_background"
    android:elevation="2dp"
    android:padding="@dimen/base_margin"
    app:behavior_hideable="true"
    app:behavior_peekHeight="@dimen/bottom_sheet_peek_height"
    app:layout_behavior="@string/bottom_sheet_behavior">

• RecyclerView滚动监听调整BottomSheet的peekHeight：

binding.rv.addOnScrollListener(new RecyclerView.OnScrollListener() {
    @Override
    public void onScrolled(@NonNull RecyclerView recyclerView, int dx, int dy) {
        super.onScrolled(recyclerView, dx, dy);
        // 136 = 80(bottom navigation高度) + 56(bottom sheet基础高度)
        if (dy < 0) {// 向下滚动
            bottomSheetBehavior.setPeekHeight(136, true);
        } else if (dy > 0) {// 向上滚动
            bottomSheetBehavior.setPeekHeight(56, true);
        }
    }
});

• 核心矛盾：
  1. 给BottomSheet设置clickable=true后，当peekHeight小于BottomNavigation高度（80dp）时，无法拖动展开BottomSheet
  2. 不设置clickable时，点击事件会穿透BottomSheet触发下方RecyclerView的条目点击，即使peekHeight未调整也存在该问题

原因分析 #

1. 点击穿透：BottomSheet根布局默认不消费触摸事件，事件会按触摸传递机制向下穿透到下层的RecyclerView
2. 拖动失效：设置clickable=true后，根布局会优先消费触摸事件，但BottomSheetBehavior的拖动逻辑依赖于对触摸事件的拦截；当peekHeight过小时，触摸事件的拦截优先级被根布局的clickable抢占，导致Behavior无法触发拖动逻辑

解决方案 #

方案1：自定义根布局，优先让Behavior处理触摸事件

创建自定义ConstraintLayout，重写触摸事件方法，确保拖动逻辑优先执行，同时消费点击事件防止穿透：

public class BottomSheetLayout extends ConstraintLayout {
    private BottomSheetBehavior<View> mBehavior;

    public BottomSheetLayout(Context context) {
        super(context);
        init();
    }

    public BottomSheetLayout(Context context, AttributeSet attrs) {
        super(context, attrs);
        init();
    }

    public BottomSheetLayout(Context context, AttributeSet attrs, int defStyleAttr) {
        super(context, attrs, defStyleAttr);
        init();
    }

    private void init() {
        mBehavior = BottomSheetBehavior.from(this);
    }

    @Override
    public boolean onInterceptTouchEvent(MotionEvent ev) {
        // 非展开状态下，优先让Behavior拦截触摸事件以支持拖动
        if (mBehavior.getState() != BottomSheetBehavior.STATE_EXPANDED) {
            return mBehavior.onInterceptTouchEvent(ev);
        }
        return super.onInterceptTouchEvent(ev);
    }

    @Override
    public boolean onTouchEvent(MotionEvent ev) {
        // 先让Behavior处理拖动逻辑，处理成功则直接返回
        if (mBehavior.onTouchEvent(ev)) {
            return true;
        }
        // 消费点击事件，避免穿透到下层View
        if (ev.getAction() == MotionEvent.ACTION_UP) {
            performClick();
            return true;
        }
        return super.onTouchEvent(ev);
    }

    @Override
    public boolean performClick() {
        super.performClick();
        return true;
    }
}

将布局中的androidx.constraintlayout.widget.ConstraintLayout替换为自定义的BottomSheetLayout，无需额外设置clickable，即可同时支持拖动和防止点击穿透。

方案2：通过OnTouchListener处理触摸事件

无需自定义布局，直接给BottomSheet根布局设置触摸监听器，手动分配事件优先级：

binding.bs.setOnTouchListener((v, event) -> {
    BottomSheetBehavior<View> behavior = BottomSheetBehavior.from(v);
    // 优先让Behavior处理拖动事件
    if (behavior.onTouchEvent(event)) {
        return true;
    }
    // 消费点击事件，阻止穿透到RecyclerView
    if (event.getAction() == MotionEvent.ACTION_UP) {
        // 可在此添加BottomSheet的点击逻辑
        return true;
    }
    return false;
});

方案3：添加拖动手柄区域

在BottomSheet顶部添加一个专门的拖动区域（如高度48dp的View），设置该区域为clickable=true，根布局不设置clickable：

<View
    android:id="@+id/drag_handle"
    android:layout_width="match_parent"
    android:layout_height="48dp"
    android:clickable="true"
    android:background="?attr/selectableItemBackgroundBorderless"
    app:layout_constraintTop_toTopOf="parent"/>

用户可通过拖动该手柄展开BottomSheet，同时根布局的点击事件可通过添加OnClickListener消费，避免事件穿透。

内容的提问来源于stack exchange，提问作者gpl