如何让RecyclerView的Header Item不可滑动？代码问题排查

我来帮你排查代码里的问题，以及给出具体的修复方案：

核心问题分析 #

你的代码里有两个关键问题导致Header仍能滑动：

1. HeaderViewHolder的类型判断可能失效：如果MaterialDetailAdapter.HeaderVH不是静态内部类，或者Adapter中getItemViewType的逻辑和ViewHolder绑定错误，会导致viewHolder instanceof MaterialDetailAdapter.HeaderVH判断为false，从而进入允许滑动的分支。
2. 滑动UI方法未做类型校验：即使getMovementFlags返回了0，若Header被错误识别为可滑动，onSelectedChanged、onChildDraw等方法中的强制类型转换会触发崩溃，同时也说明ItemTouchHelper没有正确拦截Header的滑动事件。

具体修复方案 #

1. 确保HeaderViewHolder的类型判断有效 #

首先检查MaterialDetailAdapter中的HeaderVH是否为静态内部类（非静态内部类会因为外部类实例依赖导致instanceof判断失效），同时正确实现getItemViewType区分Header和普通Item：

public class MaterialDetailAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {
    // 必须定义为static内部类，否则外部类的ViewHolder无法被正确识别
    public static class HeaderVH extends RecyclerView.ViewHolder {
        // Header视图初始化逻辑
        public HeaderVH(View itemView) {
            super(itemView);
            // ...
        }
    }

    public static class MaterialVH extends RecyclerView.ViewHolder {
        public View item;
        // 普通Item视图初始化逻辑
        public MaterialVH(View itemView) {
            super(itemView);
            item = itemView;
            // ...
        }
    }

    // 重写getItemViewType，明确区分Header和普通Item
    @Override
    public int getItemViewType(int position) {
        return position == 0 ? 0 : 1; // 假设Header在position=0的位置
    }
}

2. 修正getMovementFlags方法 #

直接在方法中明确指定滑动方向（你需要的左向右滑动对应ItemTouchHelper.RIGHT），避免依赖super.getSwipeDirs，确保逻辑清晰：

@Override
public int getMovementFlags(RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder) {
    // 优先判断是否为HeaderViewHolder
    if (viewHolder instanceof MaterialDetailAdapter.HeaderVH) {
        // 禁止拖拽和滑动，返回0标志
        return makeMovementFlags(0, 0);
    } else {
        // 允许右滑（左向右滑动），禁止拖拽
        return makeMovementFlags(0, ItemTouchHelper.RIGHT);
    }
}

3. 修复滑动UI方法的类型判断 #

在onSelectedChanged、onChildDraw等方法中，先判断ViewHolder类型再强转，避免崩溃，同时确保只有普通Item才执行滑动UI逻辑：

@Override
public void onSelectedChanged(RecyclerView.ViewHolder viewHolder, int actionState) {
    if (viewHolder != null && viewHolder instanceof MaterialDetailAdapter.MaterialVH) {
        final View foregroundView = ((MaterialDetailAdapter.MaterialVH) viewHolder).item;
        getDefaultUIUtil().onSelected(foregroundView);
    }
}

@Override
public void onChildDrawOver(Canvas c, RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder, float dX, float dY, int actionState, boolean isCurrentlyActive) {
    if (viewHolder instanceof MaterialDetailAdapter.MaterialVH) {
        final View foregroundView = ((MaterialDetailAdapter.MaterialVH) viewHolder).item;
        getDefaultUIUtil().onDrawOver(c, recyclerView, foregroundView, dX, dY, actionState, isCurrentlyActive);
    }
}

@Override
public void clearView(RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder) {
    if (viewHolder instanceof MaterialDetailAdapter.MaterialVH) {
        final View foregroundView = ((MaterialDetailAdapter.MaterialVH) viewHolder).item;
        getDefaultUIUtil().clearView(foregroundView);
    }
}

@Override
public void onChildDraw(Canvas c, RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder, float dX, float dY, int actionState, boolean isCurrentlyActive) {
    if (viewHolder instanceof MaterialDetailAdapter.MaterialVH) {
        final View foregroundView = ((MaterialDetailAdapter.MaterialVH) viewHolder).item;
        getDefaultUIUtil().onDraw(c, recyclerView, foregroundView, dX, dY, actionState, isCurrentlyActive);
    }
}

4. 可选：重写getSwipeDirs增强保险 #

虽然getMovementFlags已经足够，但可以重写getSwipeDirs实现双重校验，确保Header无法滑动：

@Override
public int getSwipeDirs(RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder) {
    if (viewHolder instanceof MaterialDetailAdapter.HeaderVH) {
        return 0;
    }
    // 只允许右滑操作
    return ItemTouchHelper.RIGHT;
}

验证逻辑 #

做完这些修改后，ItemTouchHelper会正确识别HeaderViewHolder，返回0的滑动标志，从而彻底禁止Header的滑动操作；同时普通Item会保持你需要的右滑功能，且UI方法不会因为类型转换触发崩溃。

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