Android 列表项可见性检测的优雅解法：破解通用性的难题

Android

2023-10-14 20:11:40

Android 列表项可见性检测：解耦性和通用性至上

现状的困局

在 Android 开发中，列表项可见性检测一直是一个棘手的难题。现有的方法往往依赖于手动标记或直接获取控件的可见性属性。这些方法在特定场景下可用，但缺乏普遍适用性。

手动标记需要为每个列表项添加自定义标记，操作繁琐且容易出错。而获取可见性属性则受限于控件的实现方式，难以跨控件类型使用。

解耦与通用

本文提出的解决方案将列表项可见性检测从控件中解耦出来，采用了一种更通用的方式：

状态监听： 监听列表的滚动状态变化，实时获取可见列表项的范围。
位置计算： 基于列表项的位置信息和可见范围，计算出每个列表项的可见状态。

这种解耦的方式消除了对控件实现的依赖，使方案具有更高的通用性。

实现原理

该方案主要由以下几个部分组成：

滚动状态监听器： 监听列表的滚动事件，实时获取可见列表项的起始和结束索引。
位置计算器： 计算每个列表项的相对位置，并将其与可见范围进行比较。
可见性判定器： 根据列表项的位置信息和可见范围，判定其是否可见。

具体实现步骤：

滚动状态监听： 在列表滚动时，获取当前可见列表项的起始和结束索引。
位置计算： 遍历所有列表项，计算每个列表项相对可见区域顶部的偏移量。
可见性判定： 将每个列表项的偏移量与可见范围进行比较，判定其是否可见。

实例代码

// 滚动状态监听器
class ScrollStateListener implements RecyclerView.OnScrollListener {

    private int mFirstVisibleItem;
    private int mLastVisibleItem;

    @Override
    public void onScrolled(RecyclerView recyclerView, int dx, int dy) {
        mFirstVisibleItem = recyclerView.getChildLayoutPosition(recyclerView.getChildAt(0));
        mLastVisibleItem = recyclerView.getChildLayoutPosition(recyclerView.getChildAt(recyclerView.getChildCount() - 1));
    }

    public int getFirstVisibleItem() {
        return mFirstVisibleItem;
    }

    public int getLastVisibleItem() {
        return mLastVisibleItem;
    }
}

// 位置计算器
class PositionCalculator {

    private int mVisibleTop;
    private int mVisibleBottom;

    public void setVisibleRange(int visibleTop, int visibleBottom) {
        mVisibleTop = visibleTop;
        mVisibleBottom = visibleBottom;
    }

    public boolean isVisible(int position, int offset) {
        int itemTop = offset;
        int itemBottom = offset + recyclerView.getChildAt(position).getHeight();
        return (itemTop >= mVisibleTop && itemTop <= mVisibleBottom) || (itemBottom >= mVisibleTop && itemBottom <= mVisibleBottom);
    }
}

// 可见性判定器
class VisibilityDeterminer {

    private ScrollStateListener mScrollStateListener;
    private PositionCalculator mPositionCalculator;

    public VisibilityDeterminer(ScrollStateListener scrollStateListener, PositionCalculator positionCalculator) {
        mScrollStateListener = scrollStateListener;
        mPositionCalculator = positionCalculator;
    }

    public boolean isVisible(int position) {
        int firstVisibleItem = mScrollStateListener.getFirstVisibleItem();
        int lastVisibleItem = mScrollStateListener.getLastVisibleItem();
        if (position < firstVisibleItem || position > lastVisibleItem) {
            return false;
        }
        int offset = recyclerView.getChildAt(position - firstVisibleItem).getTop();
        mPositionCalculator.setVisibleRange(mScrollStateListener.getVisibleTop(), mScrollStateListener.getVisibleBottom());
        return mPositionCalculator.isVisible(position, offset);
    }
}