TabLayout 踩坑之 onTabSelected没有被回调的问题

一、 问题描述

最近项目中有个需求:一个页面顶部有3个tab,每一个tab分别展示一个不同的页面,点击tab 切换到对应页面。进入页面是默认选中第一个页面。

这不很简单的一个需求嘛?很明显,用TabLayout 分分钟实现,于是打开Android Studio ,几分钟后写下了如下代码:

public class TabActivity extends AppCompatActivity {
    private TabLayout mTabLayout;
    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.tab_layout_ac2);
        mTabLayout = (TabLayout) findViewById(R.id.tab_layout2);

        mTabLayout.addTab(mTabLayout.newTab().setText("个性推荐"),true);//设置默认选中
        mTabLayout.addTab(mTabLayout.newTab().setText("歌单"));
        mTabLayout.addTab(mTabLayout.newTab().setText("主播电台"));

        final List<Fragment> fragments = new ArrayList<>();
        fragments.add(FirstFragment.newInstance());
        fragments.add(SecondFragment.newInstance());
        fragments.add(ThirdFragment.newInstance());

        mTabLayout.addOnTabSelectedListener(new TabLayout.OnTabSelectedListener() {
            @Override
            public void onTabSelected(TabLayout.Tab tab) {
                Log.e("TAG","tab position:"+tab.getPosition());
                replaceFragment(fragments.get(tab.getPosition()));
            }

            @Override
            public void onTabUnselected(TabLayout.Tab tab) {

            }

            @Override
            public void onTabReselected(TabLayout.Tab tab) {

            }
        });
    }

    private void replaceFragment(Fragment fragment){
        getSupportFragmentManager().beginTransaction().replace(R.id.tab_container,fragment).commit();
    }
}

写完之后,一运行,发现tab 显示出来了,第一个tab也选中了(效果如下图),但是第一页的内容咋没展示出来呢? 然后点击tab切换,切换到后面2个tab时,可以加载出页面,然后再次点击第一个tab ,第一个tab 的页面也展示出来了。
未展示页面效果
第一次进来时,tab 下面的页面内容没有展示出来,很明显,那就是第一次进来的时候onTabSelected 回调没有被执行。因为我们是在onTabSelected 来加载页面的。经过几次反复测试(日志和断点调试),确定了是第一次进入的时候,onTabSelected没有被回调。

那么,为什么第一次进入的时候,onTabSelected没有被回调了?反复检查了几次代码,没有发现问题。既然没有发现问题,那么,我们就只有去看源码了,看一下TabLayoout 初始化完成后,在什么时候调用的onTabSelected 回调方法?

二、源码追踪

我们要看一下源码中TabLayout初始化后,在什么时候调用的onTabSelected。我们注意到,添加Tab的时候,有这么一个方法:

 mTabLayout.addTab(mTabLayout.newTab().setText("个性推荐"),true);

addTab 方法有2个参数,第一个是要添加的Tab,第二个参数是是否设置为默认选中。上面这行代码的意思是,添加一个Tab,并且设置这个tab为默认选中的Tab。

接下来就走读一下源码,看一下在何时回调的onTabSelected方法:

1,首先看一下OnTabSelectedListener 的设置

 public void addOnTabSelectedListener(@NonNull OnTabSelectedListener listener) {
        if (!mSelectedListeners.contains(listener)) {
            mSelectedListeners.add(listener);
        }
    }

很简单,就是将OnTabSelectedListener保存到一个列表里。没有做其他事情。

2, 以 addTab 方法为入口,顺藤摸瓜。

    // 添加一个Tab ,并且设置为是否选中
    // 实际调用方法 addTab(@NonNull Tab tab, int position, boolean setSelected) 
    public void addTab(@NonNull Tab tab, boolean setSelected) {
        addTab(tab, mTabs.size(), setSelected);
    }

 //1, 首先将Tab 保存到一个列表中,记录位置
 //2, 将tab 添加到TabLayout 中
 //3, 判断时候选中(这就是我们要的)
 public void addTab(@NonNull Tab tab, int position, boolean setSelected) {
        if (tab.mParent != this) {
            throw new IllegalArgumentException("Tab belongs to a different TabLayout.");
        }
        configureTab(tab, position);
        addTabView(tab);
        // 是否选中
        if (setSelected) {
            tab.select();
        }
    }

如上代码,如果setSelectedtrue,就调用了tabselect()方法,我们看一下select()方法:

 public void select() {
            if (mParent == null) {
                throw new IllegalArgumentException("Tab not attached to a TabLayout");
            }
            mParent.selectTab(this);
        }

调用了Parent的select方法,Parent 是谁?当然是TabLayout 啦。所以继续深入,看看TabLayout的select方法。

  void selectTab(Tab tab) {
       //实际调用 selectTab(final Tab tab, boolean updateIndicator) 
        selectTab(tab, true);
    }

 // 
  void selectTab(final Tab tab, boolean updateIndicator) {
        final Tab currentTab = mSelectedTab;

        if (currentTab == tab) { // 如果新选中的Tab 和当前Tab 相同,回调onTabReselected 方法
            if (currentTab != null) {
                dispatchTabReselected(tab);
                animateToTab(tab.getPosition());
            }
        } else { // 如果不同,则回调 onTabSelected方法
            final int newPosition = tab != null ? tab.getPosition() : Tab.INVALID_POSITION;
            if (updateIndicator) {
                if ((currentTab == null || currentTab.getPosition() == Tab.INVALID_POSITION)
                        && newPosition != Tab.INVALID_POSITION) {
                    // If we don't currently have a tab, just draw the indicator
                    setScrollPosition(newPosition, 0f, true);
                } else {
                    animateToTab(newPosition);
                }
                if (newPosition != Tab.INVALID_POSITION) {
                    setSelectedTabView(newPosition);
                }
            }
            if (currentTab != null) {
                dispatchTabUnselected(currentTab);
            }
            mSelectedTab = tab; // 记录选中的Tab 
            if (tab != null) {
                dispatchTabSelected(tab); // 处理选中Tab 
            }
        }
    }

TabLayout 的selectTab方法中最终调用了dispatchTabSelected方法:

 private void dispatchTabSelected(@NonNull final Tab tab) {
        for (int i = mSelectedListeners.size() - 1; i >= 0; i--) {
            mSelectedListeners.get(i).onTabSelected(tab); // 找到了,在这里循环列表,分别调用onTabSelected 方法。
        }
    }

好了,到这里就找到了onTabSelected回调的地方了,有没有很熟悉 mSelectedListeners?当然了,在我们调用addOnTabSelectedListener设置监听器的时候,就是保存到mSelectedListeners的。我们来捋一捋:

源码流程

如上图:

当我们执行addTab方法添加Tab的时候,最后会调用到 dispatchTabSelected方法,在dispatchTabSelected方法里面调用addOnTabSelectedListeneronTabSelected()方法。但是这个时候,mSelectedListeners 为空(因为这个时候我们还没有设置OnTabSelectedListener),因此,就没有回调到onTabSelected

分析到此我们也就明白了,第一次没有回调到 onTabSelected 方法,是因为我们写的程序的顺序问题,应该在添加Tab 之前 添加OnTabSelectedListener 监听。

三、解决方案

通过上面的源码分析,我们知道了,第一次没有执行OnTabSelected回调,是因为我们的代码顺序问题(这个是Google 的坑,设计得有问题啊),因此,要想第一次进入的时候回调到OnTabSelected方法,我们应该先设置
addOnTabSelectedListener 监听器,再添加Tab,我们原来的程序顺序调整一下:

        // 1, 设置 addOnTabSelectedListener
        // 设置 addOnTabSelectedListener 必须在 addTab 之前。
        mTabLayout.addOnTabSelectedListener(new TabLayout.OnTabSelectedListener() {
            @Override
            public void onTabSelected(TabLayout.Tab tab) {
                Log.e("TAG","tab position:"+tab.getPosition());
                replaceFragment(fragments.get(tab.getPosition()));
            }

            @Override
            public void onTabUnselected(TabLayout.Tab tab) {

            }

            @Override
            public void onTabReselected(TabLayout.Tab tab) {

            }
        });
        // 2.添加Tab 
        mTabLayout.addTab(mTabLayout.newTab().setText("个性推荐"),true);
        mTabLayout.addTab(mTabLayout.newTab().setText("歌单"));
        mTabLayout.addTab(mTabLayout.newTab().setText("主播电台"));

通过如上调整,再运行程序,完美解决,第一次进入如下:
展示了页面内容效果

四、总结

本篇文章是对TabLayout 使用过程中遇到的一个的坑记录和总结,可能有的人不会遇到,也没有人会注意到(如果你一开始就把顺序写对了的话),但是,如果遇到的话,要看源码才知道原因。这也是我们解决问题的一种思路。很多时候,我们需要去了解一下原理和源码的实现,这样才能帮助我们更好的理解,以免使用的时候踩坑。

©️2020 CSDN 皮肤主题: 数字20 设计师:CSDN官方博客 返回首页