Android RecyclerView实现指定ViewType项吸顶效果的方法

针对多ViewType RecyclerView中特定Item的顶部固定需求（初始在底部，滚动到顶部后固定，向下滚动恢复原位），可以通过自定义RecyclerView.ItemDecoration结合滚动状态判断实现，核心思路是在需要固定时绘制目标Item的副本在RecyclerView顶部，实时根据滚动状态控制显示。

具体实现步骤 #

1. 定义目标ViewType常量

先在你的Adapter中指定需要固定的ViewType：

public static final int VIEW_TYPE_STICKY = 2; // 替换为你实际的目标ViewType值

2. 自定义StickyItemDecoration

这个Decoration负责绘制固定的Item副本，并处理滚动时的位置计算：

public class StickyItemDecoration extends RecyclerView.ItemDecoration {
    private final int mStickyViewType;
    private final RecyclerView.Adapter mAdapter;
    private View mStickyView;
    private int mStickyViewHeight;

    public StickyItemDecoration(int stickyViewType, RecyclerView.Adapter adapter) {
        mStickyViewType = stickyViewType;
        mAdapter = adapter;
    }

    @Override
    public void getItemOffsets(@NonNull Rect outRect, @NonNull View view, @NonNull RecyclerView parent, @NonNull RecyclerView.State state) {
        super.getItemOffsets(outRect, view, parent, state);
        int position = parent.getChildAdapterPosition(view);
        // 仅对目标ViewType的Item预留顶部空间，避免固定视图遮挡原Item
        if (mAdapter.getItemViewType(position) == mStickyViewType && shouldDrawStickyView(parent)) {
            outRect.top = mStickyViewHeight;
        }
    }

    @Override
    public void onDrawOver(@NonNull Canvas c, @NonNull RecyclerView parent, @NonNull RecyclerView.State state) {
        super.onDrawOver(c, parent, state);
        if (!shouldDrawStickyView(parent)) {
            mStickyView = null;
            return;
        }

        int stickyPosition = findFirstVisibleStickyPosition(parent);
        if (stickyPosition == RecyclerView.NO_POSITION) {
            return;
        }

        // 创建或复用固定视图
        if (mStickyView == null) {
            mStickyView = mAdapter.createViewHolder(parent, mStickyViewType).itemView;
            measureStickyView(parent);
        }

        // 绑定最新数据到固定视图
        mAdapter.bindViewHolder(mAdapter.createViewHolder(parent, mStickyViewType), stickyPosition);

        // 计算固定视图的顶部位置，避免与下一个目标Item重叠
        int top = parent.getPaddingTop();
        View nextStickyView = findNextStickyView(parent, stickyPosition);
        if (nextStickyView != null) {
            int nextTop = nextStickyView.getTop() - mStickyViewHeight;
            top = Math.min(top, nextTop);
        }

        // 绘制固定视图到RecyclerView顶部
        c.save();
        c.translate(parent.getPaddingLeft(), top);
        mStickyView.draw(c);
        c.restore();
    }

    /**
     * 判断是否需要显示固定视图：目标Item滚动到RecyclerView顶部区域时触发
     */
    private boolean shouldDrawStickyView(RecyclerView parent) {
        RecyclerView.LayoutManager layoutManager = parent.getLayoutManager();
        int firstVisiblePos = layoutManager.findFirstVisibleItemPosition();
        int lastVisiblePos = layoutManager.findLastVisibleItemPosition();

        for (int i = firstVisiblePos; i <= lastVisiblePos; i++) {
            if (mAdapter.getItemViewType(i) == mStickyViewType) {
                View itemView = layoutManager.findViewByPosition(i);
                if (itemView != null && itemView.getTop() <= parent.getPaddingTop()) {
                    return true;
                }
            }
        }
        return false;
    }

    /**
     * 找到第一个可见的目标Item位置
     */
    private int findFirstVisibleStickyPosition(RecyclerView parent) {
        RecyclerView.LayoutManager layoutManager = parent.getLayoutManager();
        int firstVisiblePos = layoutManager.findFirstVisibleItemPosition();
        int lastVisiblePos = layoutManager.findLastVisibleItemPosition();

        for (int i = firstVisiblePos; i <= lastVisiblePos; i++) {
            if (mAdapter.getItemViewType(i) == mStickyViewType) {
                return i;
            }
        }
        return RecyclerView.NO_POSITION;
    }

    /**
     * 找到当前固定Item的下一个目标Item，用于处理重叠问题
     */
    private View findNextStickyView(RecyclerView parent, int currentStickyPos) {
        RecyclerView.LayoutManager layoutManager = parent.getLayoutManager();
        int lastVisiblePos = layoutManager.findLastVisibleItemPosition();

        for (int i = currentStickyPos + 1; i <= lastVisiblePos; i++) {
            if (mAdapter.getItemViewType(i) == mStickyViewType) {
                return layoutManager.findViewByPosition(i);
            }
        }
        return null;
    }

    /**
     * 测量固定视图的尺寸
     */
    private void measureStickyView(RecyclerView parent) {
        RecyclerView.LayoutParams params = (RecyclerView.LayoutParams) mStickyView.getLayoutParams();
        if (params == null) {
            params = new RecyclerView.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.WRAP_CONTENT);
            mStickyView.setLayoutParams(params);
        }

        int widthSpec = View.MeasureSpec.makeMeasureSpec(
                parent.getWidth() - parent.getPaddingLeft() - parent.getPaddingRight(),
                View.MeasureSpec.EXACTLY
        );
        int heightSpec = params.height == RecyclerView.LayoutParams.WRAP_CONTENT
                ? View.MeasureSpec.makeMeasureSpec(parent.getHeight(), View.MeasureSpec.UNSPECIFIED)
                : View.MeasureSpec.makeMeasureSpec(params.height, View.MeasureSpec.EXACTLY);

        mStickyView.measure(widthSpec, heightSpec);
        mStickyViewHeight = mStickyView.getMeasuredHeight();
    }
}

3. 为RecyclerView添加Decoration

在初始化RecyclerView时，绑定自定义Decoration：

RecyclerView recyclerView = findViewById(R.id.your_recycler_view);
YourMultiTypeAdapter adapter = new YourMultiTypeAdapter(yourDataList);
LinearLayoutManager layoutManager = new LinearLayoutManager(this);

recyclerView.setAdapter(adapter);
recyclerView.setLayoutManager(layoutManager);

// 添加固定效果Decoration
StickyItemDecoration stickyDecoration = new StickyItemDecoration(YourMultiTypeAdapter.VIEW_TYPE_STICKY, adapter);
recyclerView.addItemDecoration(stickyDecoration);

关键注意事项 #

• 确保你的Adapter正确实现getItemViewType方法，返回对应的ViewType值；
• 当Adapter数据更新时，调用recyclerView.invalidateItemDecorations()刷新固定视图的数据；
• 如果使用GridLayoutManager，需要调整measureStickyView中的宽度测量逻辑，适配网格布局；
• 初始状态下目标Item在底部，只有当用户向上滚动使其顶部触及RecyclerView顶部时，固定视图才会显示；向下滚动时，原Item回到顶部以下后，固定视图自动消失，原Item恢复正常位置。

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