TabLayout初始化后onTabSelected首次没有被回调的问题

Posted 2023-02-18 yuminfeng728

我们经常使用TabLayout控件来管理多个页面的展示，但是应用不当的话，可能会给我们带来一些小小的困扰。比如说，我就曾经遇到过TabLayout 初始化后OnTabSelectedListener中 onTabSelected首次没有被回调的问题。为了深刻了解问题的缘由，还需要从代码中一窥究竟。这篇文章主要是记录当时的学习的过程。

首先列出能够避免上述问题的使用代码：

    tabLayout = findViewById(R.id.tab_layout);
    /**
     *  step 1: addOnTabSelectedListener
     */
    tabLayout.addOnTabSelectedListener(new TabLayout.OnTabSelectedListener() 
        @Override
        public void onTabSelected(TabLayout.Tab tab) 
            Log.e(TAG, "onTabSelected: " + tab.getText() + " ,count:" + tabLayout.getTabCount());

        

        @Override
        public void onTabUnselected(TabLayout.Tab tab) 
            Log.e(TAG, "onTabUnselected: " + tab.getText() + " ,count:" + tabLayout.getTabCount());
        

        @Override
        public void onTabReselected(TabLayout.Tab tab) 
            Log.e(TAG, "onTabReselected: " + tab.getText() + " ,count:" + tabLayout.getTabCount());
        
    );

    /**
     *  step 2: add new tab
     */
    tabLayout.addTab(tabLayout.newTab().setText("tab1"), false);
    tabLayout.addTab(tabLayout.newTab().setText("tab2"), false);
    tabLayout.addTab(tabLayout.newTab().setText("tab3"), false);
    tabLayout.addTab(tabLayout.newTab().setText("tab4"), false);
    tabLayout.addTab(tabLayout.newTab().setText("tab5"), false);
    //step 3:
    tabLayout.getTabAt(0).select(); //默认选中第一个tab

上面看起来与平常的使用也没有什么不同，我们只是在addTab时，设置了setSelected状态为false，这样就不会去执行tab.select()方法，这样避免了首次默认调用。而通过 step3 中自己代码控制调用select方法。

下面将从源码中追踪：

我们可以先从addTab中入手

//新增一个Tab到layout中，并且指定是否选中
//实际调用的方法在下面
public void addTab(@NonNull Tab tab, boolean setSelected) 
    addTab(tab, mTabs.size(), setSelected);


/**
 * Add a tab to this layout. The tab will be inserted at <code>position</code>.
 *
 * @param tab The tab to add
 * @param position The new position of the tab
 * @param setSelected True if the added tab should become the selected tab.
 */
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();
    

从上面代码中，我们可以看到如果是选中状态，就回去执行tab.select()方法。这就是我们需要的。

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

这里的mParent就是当前的TabLayout。

void selectTab(Tab tab) 
    selectTab(tab, true);

继续深入的看selectTab方法:

void selectTab(final Tab tab, boolean updateIndicator) 
    final Tab currentTab = mSelectedTab;
    
    if (currentTab == tab) 
        if (currentTab != null) 
            dispatchTabReselected(tab);
            animateToTab(tab.getPosition());
        
     else 
        //记录当前选中tab的位置
        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);
            
            //设置当前tab被选中状态。
            if (newPosition != Tab.INVALID_POSITION) 
                setSelectedTabView(newPosition);
            
        
        // 回调告诉之前的tab 设置为未选中状态
        if (currentTab != null) 
            dispatchTabUnselected(currentTab);
        
        mSelectedTab = tab;
        // 通知tab被选中，回调dispatchTabSelected。
        if (tab != null) 
            dispatchTabSelected(tab);
        
    

如果选中的tab与当前选中的tab相同则调用dispatchTabReselected 方法。如果之前已经存在选中的tab，则调用之前tab的dispatchTabUnselected方法，然后将新传入的tab作为当前选中的tab并执行回调dispatchTabSelected。

private void dispatchTabReselected(@NonNull final Tab tab) 
    for (int i = mSelectedListeners.size() - 1; i >= 0; i--) 
        mSelectedListeners.get(i).onTabReselected(tab);
    


private void dispatchTabUnselected(@NonNull final Tab tab) 
    for (int i = mSelectedListeners.size() - 1; i >= 0; i--) 
        mSelectedListeners.get(i).onTabUnselected(tab);
    


private void dispatchTabSelected(@NonNull final Tab tab) 
    for (int i = mSelectedListeners.size() - 1; i >= 0; i--) 
        mSelectedListeners.get(i).onTabSelected(tab);
    

上面三个回调方法分别调用了OnTabSelectedListener中三个抽象方法。所以得出想要让这三个方法能够正常执行，则必须把设置addOnTabSelectedListener放在addTab之前。如此才能避免上面遇到的问题。