Fragment可见性监听方案,多种case完美兼容

Hide 和 Show 操作

==========================================================================

Hide 和 show 操作,会促发生命周期的回调,但是 hide 和show 操作并不会,那么我们可以通过什么方法来监听呢?其实很简单,可以通过 onHiddenChanged 方法。

/**

* 调用 fragment show hide 的时候回调用这个方法

*/

override fun onHiddenChanged(hidden: Boolean) {

super.onHiddenChanged(hidden)

checkVisibility(hidden)

}

ViewPager 嵌套 Fragment

=================================================================================

ViewPager 嵌套 Fragment,这种也是很常见的一种结构。因为ViewPager 的预加载机制,在 onResume监听是不准确的。

这时候,我们可以通过 setUserVisibleHint 方法来监听,当方法传入值为true的时候,说明Fragment可见,为false的时候说明Fragment被切走了。

public void setUserVisibleHint(boolean isVisibleToUser)

有一点需要注意的是,这个方法可能先于Fragment的生命周期被调用(在FragmentPagerAdapter中,在Fragment被add之前这个方法就被调用了),所以在这个方法中进行操作之前,可能需要先判断一下生命周期是否执行了。

/**

  • Tab切换时会回调此方法。对于没有Tab的页面,[Fragment.getUserVisibleHint]默认为true。

*/

@Suppress(“DEPRECATION”)

override fun setUserVisibleHint(isVisibleToUser: Boolean) {

info(“setUserVisibleHint = $isVisibleToUser”)

super.setUserVisibleHint(isVisibleToUser)

checkVisibility(isVisibleToUser)

}

/**

* 检查可见性是否变化

* @param expected 可见性期望的值。只有当前值和expected不同,才需要做判断

*/

private fun checkVisibility(expected: Boolean) {

if (expected == visible) return

val parentVisible = if (localParentFragment == null) {

parentActivityVisible

} else {

localParentFragment?.isFragmentVisible() ?: false

}

val superVisible = super.isVisible()

val hintVisible = userVisibleHint

val visible = parentVisible && superVisible && hintVisible

info(

String.format(

“==> checkVisibility = %s  ( parent = %s, super = %s, hint = %s )”,

visible, parentVisible, superVisible, hintVisible

)

)

if (visible != this.visible) {

this.visible = visible

onVisibilityChanged(this.visible)

}

}

AndroidX 的适配(也是一个坑)

在 AndroidX 当中,FragmentAdapter 和FragmentStatePagerAdapter 的构造方法,添加一个behavior 参数实现的。

如果我们指定不同的 behavior,会有不同的表现。

  1. 当 behavior 为BEHAVIOR_RESUME_ONLY_CURRENT_FRAGMENT时,ViewPager 中切换 Fragment,setUserVisibleHint 方法将不再被调用,他会确保 onResume 的正确调用时机。

  2. 当 behavior 为BEHAVIOR_SET_USER_VISIBLE_HINT,跟之前的方式是一致的,我们可以通过 setUserVisibleHint 结合 fragment 的生命周期来监听。

//FragmentStatePagerAdapter构造方法

public FragmentStatePagerAdapter(@NonNull FragmentManager fm,

@Behavior int behavior) {

mFragmentManager = fm;

mBehavior = behavior;

}

//FragmentPagerAdapter构造方法

public FragmentPagerAdapter(@NonNull FragmentManager fm,

@Behavior int behavior) {

mFragmentManager = fm;

mBehavior = behavior;

}

@IntDef({BEHAVIOR_SET_USER_VISIBLE_HINT, BEHAVIOR_RESUME_ONLY_CURRENT_FRAGMENT})

private @interface Behavior { }

既然是这样,我们就很好适配呢,直接在 onResume 中调用checkVisibility 方法,判断当前 Fragment 是否可见。

回过头,Behavior 是如何实现的呢?

以 FragmentStatePagerAdapter 为例,我们一起来看看源码。

@SuppressWarnings({“ReferenceEquality”, “deprecation”})

@Override

public void setPrimaryItem(@NonNull ViewGroup container, int position, @NonNull Object object) {

Fragment fragment = (Fragment)object;

if (fragment != mCurrentPrimaryItem) {

if (mCurrentPrimaryItem != null) {

//当前显示Fragment

mCurrentPrimaryItem.setMenuVisibility(false);

if (mBehavior == BEHAVIOR_RESUME_ONLY_CURRENT_FRAGMENT) {

if (mCurTransaction == null) {

mCurTransaction = mFragmentManager.beginTransaction();

}

//最大生命周期设置为STARTED,生命周期回退到onPause

mCurTransaction.setMaxLifecycle(mCurrentPrimaryItem, Lifecycle.State.STARTED);

} else {

//可见性设置为false

mCurrentPrimaryItem.setUserVisibleHint(false);

}

}

//将要显示的Fragment

fragment.setMenuVisibility(true);

if (mBehavior == BEHAVIOR_RESUME_ONLY_CURRENT_FRAGMENT) {

if (mCurTransaction == null) {

mCurTransaction = mFragmentManager.beginTransaction();

}

//最大 生命周期设置为RESUMED

mCurTransaction.setMaxLifecycle(fragment, Lifecycle.State.RESUMED);

} else {

//可见性设置为true

fragment.se tUserVisibleHint(true);

}

//赋值

mCurrentPrimaryItem = fragment;

}

}

代码比较简单很好理解。

  • 当 mBehavior 设置为BEHAVIOR_RESUME_ONLY_CURRENT_FRAGMENT会通过 setMaxLifecycle 来修改当前Fragment和将要显示的Fragment的状态,使得只有正在显示的 Fragment执行到onResume() 方法,其他 Fragment 只会执行到onStart() 方法,并且当 Fragment 切换到不显示状态时触发 onPause()方法。

  • 当 mBehavior 设置为BEHAVIOR_SET_USER_VISIBLE_HINT 时,会当frament 可见性发生变化时调用 setUserVisibleHint() ,也就是跟我们上面提到的第一种懒加载实现方式一样。

宿主 Fragment 再嵌套 Fragment

====================================================================================

这种 case 也是比较常见的,比如 ViewPager 嵌套ViewPager,再嵌套 Fragment。

宿主Fragment在生命周期执行的时候会相应的分发到子Fragment中,但是setUserVisibleHint和onHiddenChanged却没有进行相应的回调。试想一下,一个ViewPager中有一个FragmentA的tab,而FragmentA中有一个子FragmentB,FragmentA被滑走了,FragmentB并不能接收到setUserVisibleHint事件,onHiddenChange事件也是一样的。

那有没有办法监听到宿主的 setUserVisibleHint 和 ,onHiddenChange 事件呢?

方法肯定是有的。

  1. 第一种方法,宿主 Fragment 提供可见性的回调,子Fragment 监听改回调,有点类似于观察者模式。难点在于子Fragment 要怎么拿到宿主 Fragment。

  2. 第二种 case,宿主 Fragment 可见性变化的时候,主动去遍历所有的 子Fragment,调用 子 Fragment 的相应方法。

第一种方法

总体思路是这样的,宿主 Fragment 提供可见性的回调,子Fragment 监听改回调,有点类似于观察者模式。也有点类似于 Rxjava 中下游持有。

第一步,我们先定义一个接口。

interface OnFragmentVisibilityChangedListener {

fun onFragmentVisibilityChanged(visible: Boolean)

}

第二步,在 BaseVisibilityFragment 中提供addOnVisibilityChangedListener和removeOnVisibilityChangedListener 方法,这里需要注意的是,我们需要用一个ArrayList 来保存所有的 listener,因为一个宿主 Fragment 可能有多个子 Fragment。

当 Fragment 可见性变化的时候,会遍历 List 调用OnFragmentVisibilityChangedListener 的onFragmentVisibilityChanged 方法 **。

open class BaseVisibilityFragment : Fragment(), View.OnAttachStateChangeListener,

OnFragmentVisibilityChangedListener {

private val listeners = ArrayList()

fun addOnVisibilityChangedListener(listener: OnFragmentVisibilityChangedListener?) {

listener?.apply {

listeners.add(this)

}

}

fun removeOnVisibilityChangedListener(listener: OnFragmentVisibilityChangedListener?) {

listener?.apply {

listeners.remove(this)

}

}

private fun checkVisibility(expected: Boolean) {

if (expected == visible) return

val parentVisible =

if (localParentFragment == null) parentActivityVisible

else localParentFragment?.isFragmentVisible() ?: false

val superVisible = super.isVisible()

val hintVisible = userVisibleHint

val visible = parentVisible && superVisible && hintVisible

if (visible != this.visible) {

this.visible = visible

listeners.forEach { it ->

it.onFragmentVisibilityChanged(visible)

}

onVisibilityChanged(this.visible)

}

}

第三步,在 Fragment attach 的时候,我们通过getParentFragment 方法,拿到宿主 Fragment,进行监听。这样,当宿主 Fragment 可见性变化的时候,子 Fragment能感应到。

override fun onAttach(context: Context) {

super.onAttach(context)

val parentFragment = parentFragment

if (parentFragment != null && parentFragment is BaseVisibilityFragment) {

this.localParentFragment = parentFragment

info(“onAttach, localParentFragment is $localParentFragment”)

localParentFragment?.addOnVisibilityChangedListener(this)

}

checkVisibility(true)

}

第二种方法

第二种方法,它的实现思路是这样的,宿主 Fragment 生命周期发生变化的时候,遍历子 Fragment,调用相应的方法,通知生命周期发生变化。

//当自己的显示隐藏状态改变时,调用这个方法通知子Fragment

private void notifyChildHiddenChange(boolean hidden) {

if (isDetached() || !isAdded()) {

return;

}

FragmentManager fragmentManager = getChildFragmentManager();

List fragments = fragmentManager.getFragments();

if (fragments == null || fragments.isEmpty()) {

return;

}

for (Fragment fragment : fragments) {

if (!(fragment instanceof IPareVisibilityObserver)) {

continue;

}

((IPareVisibilityObserver) fragment).onParentFragmentHiddenChanged(hidden);

}

}

完整代码

================================================================

/**

* Created by jun xu on 2020/11/26.

*/

interface OnFragmentVisibilityChangedListener {

fun onFragmentVisibilityChanged(visible: Boolean)

}

/**

* Created by jun xu on 2020/11/26.

* 支持以下四种 case

* 1. 支持 viewPager 嵌套 fragment,主要是通过 setUserVisibleHint 兼容,

*  FragmentStatePagerAdapter BEHAVIOR_RESUME_ONLY_CURRENT_FRAGMENT 的 case,因为这时候不会调用 setUserVisibleHint 方法,在 onResume check 可以兼容

* 2. 直接 fragment 直接 add, hide 主要是通过 onHiddenChanged

* 3. 直接 fragment 直接 replace ,主要是在 onResume 做判断

* 4. Fragment 里面用 ViewPager, ViewPager 里面有多个 Fragment 的,通过 setOnVisibilityChangedListener 兼容,前提是一级 Fragment 和 二级 Fragment 都必须继承  BaseVisibilityFragment, 且必须用 FragmentPagerAdapter 或者 FragmentStatePagerAdapter

* 项目当中一级 ViewPager adapter 比较特殊,不是 FragmentPagerAdapter,也不是 FragmentStatePagerAdapter,导致这种方式用不了

*/

open class BaseVisibilityFragment : Fragment(), View.OnAttachStateChangeListener,

OnFragmentVisibilityChangedListener {

companion object {

const val TAG = “BaseVisibilityFragment”

}

/**

* ParentActivity是否可见

*/

private var parentActivityVisible = false

/**

* 是否可见(Activity处于前台、Tab被选中、Fragment被添加、Fragment没有隐藏、Fragment.View已经Attach)

*/

private var visible = false

private var localParentFragment: BaseVisibilityFragment? =

null

private val listeners = ArrayList()

fun addOnVisibilityChangedListener(listener: OnFragmentVisibilityChangedListener?) {

listener?.apply {

listeners.add(this)

}

}

fun removeOnVisibilityChangedListener(listener: OnFragmentVisibilityChangedListener?) {

listener?.apply {

listeners.remove(this)

}

}

override fun onAttach(context: Context) {

info(“onAttach”)

super.onAttach(context)

val parentFragment = parentFragment

if (parentFragment != null && parentFragment is BaseVisibilityFr
agment) {

this.localParentFragment = parentFragment

localParentFragment?.addOnVisibilityChangedListener(this)

}

checkVisibility(true)

}

override fun onDetach() {

info(“onDetach”)

localParentFragment?.removeOnVisibilityChangedListener(this)

super.onDetach()

checkVisibility(false)

localParentFragment = null

}

override fun onResume() {

info(“onResume”)

super.onResume()

onActivityVisibilityChanged(true)

}

override fun onPause() {

info(“onPause”)

super.onPause()

onActivityVisibilityChanged(false)

}

/**

* ParentActivity可见性改变

*/

protected fun onActivityVisibilityChanged(visible: Boolean) {

parentActivityVisible = visible

checkVisibility(visible)

}

/**

* ParentFragment可见性改变

*/

override fun onFragmentVisibilityChanged(visible: Boolean) {

checkVisibility(visible)

}

override fun onCreate(savedInstanceState: Bundle?) {

info(“onCreate”)

super.onCreate(savedInstanceState)

}

override fun onViewCreated(

view: View,

savedInstanceState: Bundle?

) {

super.onViewCreated(view, savedInstanceState)

// 处理直接 replace 的 case

view.addOnAttachStateChangeListener(this)

}

/**

* 调用 fragment add hide 的时候回调用这个方法

*/

override fun onHiddenChanged(hidden: Boolean) {

super.onHiddenChanged(hidden)

checkVisibility(hidden)

}

/**

  • Tab切换时会回调此方法。对于没有Tab的页面,[Fragment.getUserVisibleHint]默认为true。

*/

override fun setUserVisibleHint(isVisibleToUser: Boolean) {

info(“setUserVisibleHint = $isVisibleToUser”)

super.setUserVisibleHint(isVisibleToUser)

checkVisibility(isVisibleToUser)

}

override fun onViewAttachedToWindow(v: View?) {

info(“onViewAttachedToWindow”)

checkVisibility(true)

}

override fun onViewDetachedFromWindow(v: View) {

info(“onViewDetachedFromWindow”)

v.removeOnAttachStateChangeListener(this)

checkVisibility(false)

}

/**

最后

小编这些年深知大多数初中级Android工程师,想要提升自己,往往是自己摸索成长,自己不成体系的自学效果低效漫长且无助

因此我收集整理了一份《2024年Android移动开发全套学习资料》,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友。

由于文件比较多,这里只是将部分目录截图出来,全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、电子书籍、讲解视频,并且后续会持续更新

一个人可以走的很快,但一群人才能走的更远!不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人

都欢迎加入我们的的圈子(技术交流、学习资源、职场吐槽、大厂内推、面试辅导),让我们一起学习成长!

如果你需要这些资料, ⬅ 专栏获取
ToUser)

}

override fun onViewAttachedToWindow(v: View?) {

info(“onViewAttachedToWindow”)

checkVisibility(true)

}

override fun onViewDetachedFromWindow(v: View) {

info(“onViewDetachedFromWindow”)

v.removeOnAttachStateChangeListener(this)

checkVisibility(false)

}

/**

最后

小编这些年深知大多数初中级Android工程师,想要提升自己,往往是自己摸索成长,自己不成体系的自学效果低效漫长且无助

因此我收集整理了一份《2024年Android移动开发全套学习资料》,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友。

[外链图片转存中…(img-HipKxoR5-1719189710458)]

[外链图片转存中…(img-fnEzyUG5-1719189710459)]

[外链图片转存中…(img-yxOxN8wh-1719189710460)]

[外链图片转存中…(img-oj5En91V-1719189710461)]

由于文件比较多,这里只是将部分目录截图出来,全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、电子书籍、讲解视频,并且后续会持续更新

一个人可以走的很快,但一群人才能走的更远!不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人

都欢迎加入我们的的圈子(技术交流、学习资源、职场吐槽、大厂内推、面试辅导),让我们一起学习成长!

如果你需要这些资料, ⬅ 专栏获取

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值