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

我们经常使用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之前。如此才能避免上面遇到的问题。