两步搞定Fragment的返回键

作者: 怪盗kidou | 来源:发表于2016-03-20 03:51 被阅读20089次

    Fragment可以说是在Android开发必需要使用到技术,项目中的界面基本上都是使用Fragment来实现,而Activity只是作为Fragment的载体,但有些特殊情况下Fragment也不得不处理Back键,如果是Activity的话还好说,直接覆盖 Activity的onBackPressed 即可,但Fragment可就没有这么幸运了,你可能和我一样,最开始有这样的需求的时候都会想去覆盖Fragment的onBackPressed方法,但是事与愿违,Fragment中并没有这样的方法,不仅如此,Fragment也没有更不可能有onKeyDownonKeyUp这样的方法,那么Fragment如何处理back键成难题。

    在此之前先卖个关子看看别人都是怎么实现的,看过的该方式的同学可以直接到最后。

    别人的实现方式

    注:出自优雅的让Fragment监听返回键
    1、定义一个BackHandledInterface

    public interface BackHandledInterface {
        public abstract void setSelectedFragment(BackHandledFragment selectedFragment);  
    }  
    

    2、定义一个BackHandledFragment 抽象类继承Fragment并提供一个onBackPressed方法,所有的Fragment都派生自该类

    public abstract class BackHandledFragment extends Fragment {  
        protected BackHandledInterface mBackHandledInterface;  
        protected abstract boolean onBackPressed();  
          
        @Override  
        public void onCreate(Bundle savedInstanceState) {  
            super.onCreate(savedInstanceState);  
            if(!(getActivity() instanceof BackHandledInterface)){  
                throw new ClassCastException("Hosting Activity must implement BackHandledInterface");  
            }else{  
                this.mBackHandledInterface = (BackHandledInterface)getActivity();  
            }  
        }  
        @Override  
        public void onStart() {  
            super.onStart();  
            mBackHandledInterface.setSelectedFragment(this);  
        } 
    }  
    

    3、Activity实现第一步中定义的BackHandledInterface接口

    public class MainActivity extends FragmentActivity implements BackHandledInterface{  
      
        private BackHandledFragment mBackHandedFragment;  
        private boolean hadIntercept;  
      
        @Override  
        public void setSelectedFragment(BackHandledFragment selectedFragment) {  
            this.mBackHandedFragment = selectedFragment;  
        }  
          
        @Override  
        public void onBackPressed() {  
            if(mBackHandedFragment == null || !mBackHandedFragment.onBackPressed()){  
                if(getSupportFragmentManager().getBackStackEntryCount() == 0){  
                    super.onBackPressed();  
                }else{  
                    getSupportFragmentManager().popBackStack();  
                }  
            }  
        }  
    }  
    

    原理分析

    1、利用Fragment的生命周期,在Fragment显示时通知到Activity,并由Activity保持。
    2、当用户按下Acitivity时,首先将back键请求交给Fragment处理,如果处理返回true,未处理时返回false
    3、如果Fragment没有处理则由Activity处理。

    存在的问题

    1、只适用于一个Activity上只有一个Fragment的情况。
    2、只适用于没有Fragment嵌套的情况。

    改进方式

    1、将Activity中的BackHandledFragment 改为List<BackHandledFragment> 。
    2、为保证Fragment存在嵌套的情况下也能正常使用,Fragment本身也要用List<BackHandledFragment> 持有 子可见Fragment的引用集合。
    3、Fragment不可见时通知Activity或父Fragment移除。
    4、当用户按下back键时遍历所有的可见Fragment,同样为了支持嵌套的情况Fragment本身也要遍历所有的
    子可见Fragment。

    虽然这样可以,但是这样太麻烦了,还得自己持有Fragment实例,难道就没有更好的方法?


    新实现方式

    其实我们根本不用去持有各个Fragment的实例,FragmentManager已经帮我们做了。
    Activity中的有的Fragment由FragmentManager管理,Fragment嵌套的子Fragment也由FragmentManager处理,那只要拿到FragmentManager就可以用递归的方式处理了,等等,我好像发现了什么。

    1、同样的先定义一个FragmentBackHandler 接口。

    public interface FragmentBackHandler {
        boolean onBackPressed();
    }
    

    2、定义一个BackHandlerHelper工具类,用于实现分发back事件,Fragment和Activity的外理逻辑是一样,所以两者都需要调用该类的方法。

    public class BackHandlerHelper {
    
        /**
         * 将back事件分发给 FragmentManager 中管理的子Fragment,如果该 FragmentManager 中的所有Fragment都
         * 没有处理back事件,则尝试 FragmentManager.popBackStack()
         *
         * @return 如果处理了back键则返回 <b>true</b>
         * @see #handleBackPress(Fragment)
         * @see #handleBackPress(FragmentActivity)
         */
        public static boolean handleBackPress(FragmentManager fragmentManager) {
            List<Fragment> fragments = fragmentManager.getFragments();
    
            if (fragments == null) return false;
    
            for (int i = fragments.size() - 1; i >= 0; i--) {
                Fragment child = fragments.get(i);
    
                if (isFragmentBackHandled(child)) {
                    return true;
                }
            }
    
            if (fragmentManager.getBackStackEntryCount() > 0) {
                fragmentManager.popBackStack();
                return true;
            }
            return false;
        }
    
        public static boolean handleBackPress(Fragment fragment) {
            return handleBackPress(fragment.getChildFragmentManager());
        }
    
        public static boolean handleBackPress(FragmentActivity fragmentActivity) {
            return handleBackPress(fragmentActivity.getSupportFragmentManager());
        }
    
        /**
         * 判断Fragment是否处理了Back键
         *
         * @return 如果处理了back键则返回 <b>true</b>
         */
        public static boolean isFragmentBackHandled(Fragment fragment) {
            return fragment != null
                    && fragment.isVisible()
                    && fragment.getUserVisibleHint() //for ViewPager
                    && fragment instanceof FragmentBackHandler
                    && ((FragmentBackHandler) fragment).onBackPressed();
        }
    }
    

    3、当然 Fragment 也要实现 FragmentBackHandler接口(按需)

    //没有处理back键需求的Fragment不用实现
    public abstract class BackHandledFragment extends Fragment implements FragmentBackHandler {
        @Override
        public boolean onBackPressed() {
            return BackHandlerHelper.handleBackPress(this);
        }
    }
    

    4、Activity覆盖onBackPressed方法(必须)

    public class MyActivity extends FragmentActivity {
        //.....
        @Override
        public void onBackPressed() {
            if (!BackHandlerHelper.handleBackPress(this)) {
                super.onBackPressed();
            }
        }
    }
    

    不是说好的两步么,这TM是4步啊!大哥不要生气,第一步和第二步我都给你做了,你只要在Gradle中加入以下的话以及第3、4步即可。你可以使用我提供的BackHandledFragment也可以让自己的BaseFragment实现FragmentBackHandler接口(只在需要Fragmen中实现就行),并在onBackPressed中用填入return BackHandlerHelper.handleBackPressed(this);

    allprojects {
        repositories {
            ...
            maven { url "https://jitpack.io" }
        }
    }
    dependencies {
        compile 'com.github.ikidou:FragmentBackHandler:2.1'
    }
    

    当你需要自己处理back事件时覆盖onBackPressed方法,如:

    @Override
    public boolean onBackPressed() {
    // 当确认没有子Fragmnt时可以直接return false
        if (backHandled) {
            Toast.makeText(getActivity(), toastText, Toast.LENGTH_SHORT).show();
            return true;
        } else { 
            return BackHandlerHelper.handleBackPress(this);
        }
    }
    

    图示

    Fragment的back键处理原理

    图中红色部分为BackHandledFragment 或其它实现了 FragmentBackHandler的Fragment。
    back事件由下往上传递,当中间有未实现FragmentBackHandler的Fragment作为其它Fragment的容器时,或该Fragment拦截了事件时,其子Fragment无法处理back事件。
    有没有一种似曾相识的感觉?其实这和View的事件分发机制是一个道理。

    原理

    1、不管是Activity也好,Fragment也好,其中内部包含的Fragment都是通过FragmentManager来管理的。
    2、FragmentManager.getFragments()可以获取当前Fragment/Activity中处于活动状态的所有Fragment
    3、事件由Activity交给当前Fragment处理,如果Fragment有子Fragment的情况同样可以处理。

    这么做的好处

    1、Activity不必实现接口,仅需在onBackPressed中调用BackHandlerHelper.handleBackPress(this)即可,Fragment同理。
    2、支持多个Fragment
    3、支持Fragment嵌套
    4、改动小,只修改有拦截back键需求的Fragment及其父Fragment,其它可以不动。

    结语

    本人不善言辞,也是第一次写博文,如有不对的地方请多指正,如果你有更好的办法请给我留言交流。

    部分代码有删减,完整版请见Github:FragmentBackHandler

    相关文章

      网友评论

      • 用户77:很棒的方法!:smile:
      • jiangbin1992:我一点要给你个赞
      • 9f66d5b90571:我一步步按你的代码写,最后一点返回键,就直接退出到桌面,请问是什么问题?
      • flovm:看完感觉茅塞顿开了,谢谢
        怪盗kidou::relieved: 那就好,说明这篇博客是有意义的
      • 奇葩AnJoiner:完美解决我的问题,谢谢~~
      • bwzhny:有RXAndroid 的和butterknife的吗
        怪盗kidou:@bwzhny 暂时没有,后面看情况
      • 相互交流:fragmentManager.popBackStack();楼主可否遇到过,这个退出栈的bug,,,连续退出,在进入最先退出的那个页面,,退回栈就会有问题了...
        蓅哖伊人为谁笑:@相互交流 popBackStack是Fragment的一个bug
      • 899e2d74bdeb:请问,我代码中已经不再使用v4包了,这对导入你的代码会有兼容性的问题,卡在android.app.FragmentManager 中并没有getFragments 方法,请问有什么有方法解决。
        怪盗kidou:@哎疯 这个确定没有可以直接调用的API,可以考虑用反射取值
      • 放纵的卡尔:我一般都是建一个list存储所有的fragment,然后调用Activity的onBack方法.通过tag或者instance,判断fragment的实例.这么来处理的.
        研究下楼主的方法!
      • 无无90:谢谢分享,先用上,然后再细看。
      • findvoid:很不错:smile:
      • Clement_wu:support V4 包的fragment可以,但非support包呢,没有fragmentManager.getFragments(),要自己维护一个列表?
        怪盗kidou:@Clement_wu :v:
        Clement_wu:@怪盗kidou 赞一个,谢谢提供的思路,本人结合实际项目情况,快捷解决了这个问题,谢谢
        怪盗kidou:@Clement_wu 个人主要是以 v4包中的fragment为主,所以暂时没有加入非 v4 的支持,下一版加入。
      • 饭饭团团:566666666666666666666666666666
      • sakurajiang:还是不知道怎么用
        @Override
        public boolean onBackPressed() {
        // 当确认没有子Fragmnt时可以直接return false
        if (backHandled) {
        Toast.makeText(getActivity(), toastText, Toast.LENGTH_SHORT).show();
        return true;
        } else {
        return BackHandlerHelper.handleBackPress(this);
        }
        }
        我想知道这里的backHandled是自己定义的变量,还是什么?
        sakurajiang:@sakurajiang 能直接设置成true吗?有一个完整的demo吗?
        sakurajiang:@sakurajiang 能直接设置成true吗?
        怪盗kidou:@sakurajiang backHandled 代表你在这里已经处理过返回键了,至于他是个变量还是boolean的方法返回值都行
      • hackware:太麻烦了!
      • e6da7f5b5d47:点赞,思路很不错!
        handleBackPress(FragmentManager fragmentManager)的for循环里面可以继续调用handleBackPress(Fragment fragment),实现递归,这样在嵌套Fragment时,外层的Fragment就不用做任何处理了
        怪盗kidou:@Perley :grin:
      • 你需要一台永动机:楼主我在夸你一下,还不错哟
        怪盗kidou:@艹羊 :grin:
      • 你需要一台永动机:楼主机智呀
      • GoodGoodStuday:你把相应的借口 对象也删除啊,,activity里面不去继承接口。。
      • GoodGoodStuday:我把 他写的那个 接口、继承的fragment 去掉,也能实现功能啊。。。这就有点困惑了
        怪盗kidou:@小宝拜财神 你把接口删除了,那编译都通不过,还怎么实现功能?
      • GoodGoodStuday: MainActivity extends FragmentActivity implements
        BackHandledInterface {
        private static MainActivity mInstance;
        private BackHandledFragment mBackHandedFragment;
        private Button btnSecond;

        @Override
        public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        btnSecond = (Button) findViewById(R.id.btnSecond);

        // btnSecond.setVisibility(View.VISIBLE);
        btnSecond.setOnClickListener(new OnClickListener() {

        @Override
        public void onClick(View v) {
        FirstFragment first = new FirstFragment();
        loadFragment(first);
        // btnSecond.setVisibility(View.GONE);
        }
        });

        }

        public static MainActivity getInstance() {
        if (mInstance == null) {
        mInstance = new MainActivity();
        }
        return mInstance;
        }

        public void loadFragment(BackHandledFragment fragment) {
        BackHandledFragment second = fragment;
        FragmentManager fm = getSupportFragmentManager();
        FragmentTransaction ft = fm.beginTransaction();
        ft.replace(R.id.firstFragment, second, "other");
        ft.addToBackStack("tag");
        ft.commit();
        }

        @Override
        public void setSelectedFragment(BackHandledFragment selectedFragment) {
        this.mBackHandedFragment = selectedFragment;
        }

        @Override
        public void onBackPressed() {
        if (mBackHandedFragment == null || !mBackHandedFragment.onBackPressed()) {
        if (getSupportFragmentManager().getBackStackEntryCount() == 0) {
        super.onBackPressed();
        } else {
        if (getSupportFragmentManager().getBackStackEntryCount() == 1) {
        btnSecond.setVisibility(View.VISIBLE);
        }
        getSupportFragmentManager().popBackStack();
        }
        }
        }
        }
      • GoodGoodStuday:大哥 你好,本来早就该发了,在忙都忘了。。。 我在博客里面也看见过类似的demo。。
        代码如下: 这也是那个接口 public interface BackHandledInterface {

        public abstract void setSelectedFragment(BackHandledFragment selectedFragment);
        }

        继承的fragment:public abstract class BackHandledFragment extends Fragment {

        protected BackHandledInterface mBackHandledInterface;

        /**
        * 所有继承BackHandledFragment的子类都将在这个方法中实现物理Back键按下后的逻辑
        */
        protected abstract boolean onBackPressed();

        @Override
        public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        if (!(getActivity() instanceof BackHandledInterface)) {
        throw new ClassCastException(
        "Hosting Activity must implement BackHandledInterface");
        } else {
        this.mBackHandledInterface = (BackHandledInterface) getActivity();
        }
        }

        @Override
        public void onStart() {
        super.onStart();
        // 告诉FragmentActivity,当前Fragment在栈顶
        mBackHandledInterface.setSelectedFragment(this);
        }

        }
        这是那mainactivity :

      • 69fdca87505c:不错哟
        怪盗kidou:@不写代码的程序员 都是晚上和周末写,总得回馈一下社会嘛
        69fdca87505c: @怪盗kidou 一天工作不忙哟有闲情逸致来写博文啦
        怪盗kidou: @不写代码的程序员 献丑了
      • wjehovah:nice solution
      • 红发_SHANKS:记得曾今在一个地方看到过有一个方法可以直接监听fragment的返回啊
        怪盗kidou:@壹分君 不仅仅是监听返回还要能拦截back,处理自己的逻辑。
      • RidingWind2023:看了第一遍有点绕 等会再研究下 支持下博主
        怪盗kidou:@海上牧云 和ViewGroup的事件分发是一回事。

      本文标题:两步搞定Fragment的返回键

      本文链接:https://www.haomeiwen.com/subject/qiwhlttx.html