如何为RecyclerView添加随Item状态动态适配的带文本分隔符并修复对齐问题

问题背景 #

需要给展示好友列表的RecyclerView添加「Present（已到场）」和「Invited（已邀请）」分组分隔符，要求：

• 列表项根据FriendsModel的status（0=已邀请，1=已到场）自动分组
• 当用户状态变化时，对应列表项从「Invited」组移动到「Present」组，分组数量动态更新
• 当前通过SeparationDecorator实现了基础功能，但数据动态变化时，分隔符出现对齐错位问题

问题根源分析 #

原实现存在几个核心缺陷：

• 使用静态变量printPresentAt和printInviteAt存储分隔符位置，RecyclerView数据更新时，静态变量状态无法及时同步，导致错位
• 依赖全局计数MyGlobal.getPresentCount()/MyGlobal.getInviteCount()计算位置，而非直接从Adapter数据源获取，易出现数据不一致
• onDrawOver中每次遍历可见item都重复计算分组位置，逻辑冗余且易出错
• getItemOffsets依赖静态变量判断间距，数据更新后无法匹配新位置

解决方案 #

核心修改思路 #

1. 移除静态变量：每次绘制分隔符时，直接从Adapter数据源判断当前位置是否需要显示分组标题
2. 基于数据源判断：不再依赖全局计数，通过Adapter获取对应位置的FriendsModel，结合前后item状态决定是否绘制分隔符
3. 精确控制刷新：item状态变化时，使用notifyItemMoved+notifyItemChanged而非notifyDataSetChanged，保证动画和状态同步

修改后的SeparationDecorator代码 #

public class SeparationDecorator extends RecyclerView.ItemDecoration {
    private int textSize = 50;
    private int groupSpacing = 100;
    private Paint paint = new Paint();

    public SeparationDecorator() {
        paint.setTextSize(textSize);
        // 可选：设置文本颜色，提升可读性
        paint.setColor(Color.GRAY);
    }

    @Override
    public void onDrawOver(Canvas c, RecyclerView parent, RecyclerView.State state) {
        RecyclerView.Adapter adapter = parent.getAdapter();
        if (adapter == null) return;

        int childCount = parent.getChildCount();
        for (int i = 0; i < childCount; i++) {
            View view = parent.getChildAt(i);
            int position = parent.getChildAdapterPosition(view);
            if (position == RecyclerView.NO_POSITION) continue;

            FriendsModel currentModel = (FriendsModel) adapter.getItem(position);
            boolean isPresentGroupStart = false;
            boolean isInvitedGroupStart = false;

            // 判断当前item是否是分组的第一个元素
            if (position == 0) {
                isPresentGroupStart = currentModel.getStatus() == 1;
                isInvitedGroupStart = currentModel.getStatus() == 0;
            } else {
                FriendsModel prevModel = (FriendsModel) adapter.getItem(position - 1);
                if (prevModel.getStatus() != currentModel.getStatus()) {
                    isPresentGroupStart = currentModel.getStatus() == 1;
                    isInvitedGroupStart = currentModel.getStatus() == 0;
                }
            }

            // 绘制分组标题
            float textX = view.getLeft();
            float textY = view.getTop() - groupSpacing + textSize;
            if (isPresentGroupStart) {
                c.drawText("Present", textX, textY, paint);
            } else if (isInvitedGroupStart) {
                c.drawText("Invited", textX, textY, paint);
            }
        }
    }

    @Override
    public void getItemOffsets(Rect outRect, View view, RecyclerView parent, RecyclerView.State state) {
        RecyclerView.Adapter adapter = parent.getAdapter();
        if (adapter == null) return;

        int position = parent.getChildAdapterPosition(view);
        if (position == RecyclerView.NO_POSITION) return;

        FriendsModel currentModel = (FriendsModel) adapter.getItem(position);
        boolean isGroupStart = false;

        // 判断当前item是否需要添加分组顶部间距
        if (position == 0) {
            isGroupStart = true;
        } else {
            FriendsModel prevModel = (FriendsModel) adapter.getItem(position - 1);
            isGroupStart = prevModel.getStatus() != currentModel.getStatus();
        }

        outRect.set(0, isGroupStart ? groupSpacing : 0, 0, 0);
    }
}

Adapter中处理状态变化的示例 #

当好友状态从「Invited」变为「Present」时，调整其列表位置并通知RecyclerView刷新：

// 假设Adapter持有List<FriendsModel> dataList作为数据源
public void updateFriendStatus(String uid, int newStatus) {
    int oldPosition = -1;
    FriendsModel targetModel = null;

    // 定位目标item
    for (int i = 0; i < dataList.size(); i++) {
        if (dataList.get(i).getUid().equals(uid)) {
            oldPosition = i;
            targetModel = dataList.get(i);
            break;
        }
    }
    if (targetModel == null) return;

    // 移除旧位置item
    dataList.remove(oldPosition);
    // 根据新状态插入到对应分组
    int insertPosition = 0;
    if (newStatus == 1) {
        // 插入到Present组末尾
        while (insertPosition < dataList.size() && dataList.get(insertPosition).getStatus() == 1) {
            insertPosition++;
        }
    } else {
        // 插入到Invited组开头
        while (insertPosition < dataList.size() && dataList.get(insertPosition).getStatus() == 1) {
            insertPosition++;
        }
    }
    dataList.add(insertPosition, targetModel);

    // 通知RecyclerView精确更新
    notifyItemRemoved(oldPosition);
    notifyItemInserted(insertPosition);
    notifyItemChanged(insertPosition);
}

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