如何使用TabLayout

情境

如果要使用 TabLayout 在 Android 早期是很痛苦的
漸漸的有很多優秀的第三方出來支援
包含 Indicater、ViewPager 等等…

由於太常使用這些元件
因此 Google 這次在 android.support.design 這包 library 內
直接就提供 TabLayout 讓你快速建立好一個 Tab 元件
下面我們透過 ViewPager 搭配 TabLayout 來建立連動

程式碼下載

你可以到 GitHub 上面觀看或下載完整的程式碼

• GitHub

程式碼說明

一開始要使用這個元件
在 Gradle 就要把它 import 進來
這邊的版本號是根據你的 Android SDK 來調整版號
因此你可以根據自己的版本來進行調整

dependencies {
    compile 'com.android.support:design:22.2.0'
}

接著在 activity_main.xml 內掛上你的 TabLayout
在 TabLayout 的下方放了一個 ViewPager
等下可以在 MainActvitity.java 程式內操作這兩個元件

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools" 
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin"
    android:paddingBottom="@dimen/activity_vertical_margin"
    tools:context=".MainActivity">

    <android.support.design.widget.TabLayout
        android:id="@+id/tabs"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />
    <android.support.v4.view.ViewPager
        android:id="@+id/viewpager"
        android:layout_below="@id/tabs"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        />
</RelativeLayout>

ViewPager 會需要一個自定義的 Adapter
這個 Adapter 需要一個佈局
所以我們設計了一個 pager_item.xml 如下方佈局

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
     android:layout_width="match_parent"
     android:layout_height="match_parent"
     android:orientation="vertical"
     android:gravity="center">
    <TextView
        android:id="@+id/item_subtitle"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textAppearance="?android:attr/textAppearanceLarge"
        android:text="Page:"/>

    <TextView
        android:id="@+id/item_title"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textSize="80sp" />
</LinearLayout>

接著我們來看一下 MainActvity.java 這段程式碼
可以看到一開始我們從 xml 取出 TabLayout 以及 ViewPager 的物件

public class MainActivity extends Activity {
    private android.support.design.widget.TabLayout mTabs;
    private ViewPager mViewPager;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        mTabs = (android.support.design.widget.TabLayout) findViewById(R.id.tabs);
        mTabs.addTab(mTabs.newTab().setText("Tab 1"));
        mTabs.addTab(mTabs.newTab().setText("Tab 2"));
        mTabs.addTab(mTabs.newTab().setText("Tab 3"));

        mViewPager = (ViewPager) findViewById(R.id.viewpager);
        mViewPager.setAdapter(new SamplePagerAdapter());                   mViewPager.addOnPageChangeListener(newTabLayout.TabLayoutOnPageChangeListener(mTabs));
    }

    class SamplePagerAdapter extends PagerAdapter {

        @Override
        public int getCount() {
            return 3;
        }

        @Override
        public boolean isViewFromObject(View view, Object o) {
            return o == view;
        }

        @Override
        public CharSequence getPageTitle(int position) {
            return "Item " + (position + 1);
        }

        @Override
        public Object instantiateItem(ViewGroup container, int position) {
            View view = getLayoutInflater().inflate(R.layout.pager_item,
                    container, false);
            container.addView(view);
            TextView title = (TextView) view.findViewById(R.id.item_title);
            title.setText(String.valueOf(position + 1));
            return view;
        }
        @Override
        public void destroyItem(ViewGroup container, int position, Object object) {
            container.removeView((View) object);
        }
    }
}

這邊你會發現一個重點
就是當 TabLayout 被點選的時候 下方的 ViewPager 就必須跟著滾動
同理當下方 ViewPager 滾動的時候 上方的 TabLayout 就必須跟著跳動
因此會加入這兩行

mViewPager.addOnPageChangeListener(new TabLayout.TabLayoutOnPageChangeListener(mTabs));
mTabs.setOnTabSelectedListener(new TabLayout.ViewPagerOnTabSelectedListener(mViewPager));

但是你會發現
在 setOnTabSelectedListener API 24 的時候已經被棄用了
取而代之的是 addOnTabSelectedListener
因此你可以看到使用以下的方法
也可以跟 ViewPager 和 TabLayout 的連動綁在一起

mViewPager.addOnPageChangeListener(new TabLayout.TabLayoutOnPageChangeListener(mTabs));
mTabs.addOnTabSelectedListener(new TabLayout.ViewPagerOnTabSelectedListener(mViewPager));

另外還有一種方法就是當你在點選 Tab 頁面的時候
還會額外再進行一些事情
那麼你就可以透過以下的方式來進行切換

mTabs.setOnTabSelectedListener(new TabLayout.OnTabSelectedListener() {
    @Override
    public void onTabSelected(TabLayout.Tab tab) {
        mViewPager.setCurrentItem(tab.getPosition());
    }

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

    }

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

    }
});

同樣的這個方法也在 API 24 被棄用了
當然還是有替代方案

mTabs.addOnTabSelectedListener(new TabLayout.OnTabSelectedListener() {
    @Override
    public void onTabSelected(TabLayout.Tab tab) {
        mViewPager.setCurrentItem(tab.getPosition());
    }

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

    }

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

    }
});

如此一來就可以很輕鬆的把上下兩個元件的連動綁在一起了
如下圖短短幾行就可以看到很棒的效果

這邊可以看到滾動翻頁的效果