Fragment 可见性监听，如影随形 - 全面兼容，省心省力

2023-12-21 19:57:29

掌控 Fragment 可见性：基于 ViewTreeObserver 的一站式监听方案

前言

在 Android 开发中，Fragment 扮演着不可或缺的角色。为了充分利用 Fragment 的强大功能，掌控其可见性至关重要。传统的监听方案往往存在局限性，难以满足复杂场景的需求。本文将介绍基于 ViewTreeObserver 的一站式 Fragment 可见性监听方案，它将为您扫清监听障碍，助您轻松驾驭 Fragment。

传统方案的困局

过往的 Fragment 可见性监听方案常面临以下困境：

系统回调不全面： 系统提供的 Fragment 生命周期回调无法覆盖所有可见性变化场景。
手动判断容易出错： 基于 Fragment 生命周期回调的手动判断，容易因特殊情况而漏判或误判。
兼容性差： 某些方案仅适用于特定版本或特定场景，兼容性欠佳。

ViewTreeObserver：灵敏可靠的监听基石

本方案采用 Android 系统提供的 ViewTreeObserver 类作为监听基石。ViewTreeObserver 负责监听 Fragment 根布局的树状结构变化。当 Fragment 显示或隐藏时，布局树结构也会随之改变，从而触发监听回调。

方案实现：监听布局变化，把握可见性

// Fragment 可见性监听器
class FragmentVisibilityListener(private val fragment: Fragment) : ViewTreeObserver.OnGlobalLayoutListener {
    private var isVisible = false

    // 监听可见性变化
    override fun onGlobalLayout() {
        val view = fragment.view ?: return
        val rect = Rect()
        view.getWindowVisibleDisplayFrame(rect)
        val visibleArea = rect.width() * rect.height()
        val totalArea = view.width * view.height

        val newIsVisible = visibleArea > 0 && totalArea > 0

        // 可见性发生改变时触发回调
        if (isVisible != newIsVisible) {
            isVisible = newIsVisible
            onVisibilityChanged(newIsVisible)
        }
    }

    // 可见性改变时的回调
    fun onVisibilityChanged(isVisible: Boolean) {}

    // 注册监听
    fun register() {
        fragment.view?.viewTreeObserver?.addOnGlobalLayoutListener(this)
    }

    // 注销监听
    fun unregister() {
        fragment.view?.viewTreeObserver?.removeOnGlobalLayoutListener(this)
    }
}

使用方法：轻量注册，轻松监听

在 Fragment 中使用该方案十分简单：

实例化 FragmentVisibilityListener。
在 onViewCreated() 中注册监听。
在 onDestroyView() 中注销监听。
在 onVisibilityChanged() 回调中处理可见性变化逻辑。

兼容性及局限性：广泛兼容，应对特殊场景

本方案兼容 Android 4.0 及以上版本，涵盖大多数场景。但以下特殊情况可能无法监听：

Fragment 在非可见状态下创建或销毁。
Fragment 在嵌套 Fragment 或 ViewPager 中，且其父布局不可见。

结语：掌控可见性，驾驭 Fragment

通过 ViewTreeObserver，我们构建了一套完善、可靠、兼容性强的 Fragment 可见性监听方案。它有效解决了传统方案的痛点，让开发者可以轻松掌控 Fragment 的可见性变化，从而实现各种复杂需求。赶快将此方案应用到您的项目中，告别监听烦恼，尽情挥洒代码的魅力吧！

常见问题解答

为什么传统方案无法满足所有场景？
因为系统回调不全面，且手动判断容易出错。
ViewTreeObserver 的监听原理是什么？
它监听 Fragment 根布局的树状结构变化，当布局发生变化时触发回调。
本方案的兼容性如何？
兼容 Android 4.0 及以上版本，但无法监听 Fragment 在非可见状态下创建或销毁的情况。
如何使用该方案监听 Fragment 的可见性？
在 Fragment 中实例化 FragmentVisibilityListener，注册监听，并在 onVisibilityChanged() 回调中处理逻辑。
为什么本方案在某些特殊情况下无法监听？
因为 ViewTreeObserver 无法监听 Fragment 在不可见状态下的创建或销毁，以及嵌套在不可见父布局中的 Fragment。