使用Tabs創建Swipe視圖

編寫:Lin-H - 原文:http://developer.android.com/training/implementing-navigation/lateral.html

Swipe View提供在同級屏幕中的橫向導航,例如通過橫向劃屏手勢切換的tab(一種稱作橫向分頁的模式)。這節課會教你如何使用swipe view創建一個tab layout實現在tab之間切換,或顯示一個標題條替代tab。

Swipe View 設計

在實現這些功能之前,你要先明白在Designing Effective Navigation, Swipe Views design guide中的概念和建議

實現Swipe View

你可以使用Support Library中的ViewPager控件在你的app中創建swipe view。ViewPager是一個子視圖在layout上相互獨立的佈局控件(layout widget)。

使用ViewPager來設置你的layout,要添加一個<ViewPager>元素到你的XML layout中。例如,在你的swipe view中如果每一個頁面都會佔用整個layout,那麼你的layout應該是這樣:

<?xml version="1.0" encoding="utf-8"?>
<android.support.v4.view.ViewPager
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/pager"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

要插入每一個頁面的子視圖,你需要把這個layout與PagerAdapter掛鉤。有兩種adapter(適配器)你可以用:

FragmentPagerAdapter

在同級屏幕(sibling screen)只有少量的幾個固定頁面時,使用這個最好。

FragmentStatePagerAdapter

當根據對象集的數量來劃分頁面,即一開始頁面的數量未確定時,使用這個最好。當用戶切換到其他頁面時,fragment會被銷燬來降低內存消耗。

例如,這裡的代碼是當你使用FragmentStatePagerAdapter來在Fragment對象集合中進行橫屏切換:

public class CollectionDemoActivity extends FragmentActivity {
    // 當被請求時, 這個adapter會返回一個DemoObjectFragment,
    // 代表在對象集中的一個對象.
    DemoCollectionPagerAdapter mDemoCollectionPagerAdapter;
    ViewPager mViewPager;

    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_collection_demo);

        // ViewPager和他的adapter使用了support library
        // fragments,所以要用getSupportFragmentManager.
        mDemoCollectionPagerAdapter =
                new DemoCollectionPagerAdapter(
                        getSupportFragmentManager());
        mViewPager = (ViewPager) findViewById(R.id.pager);
        mViewPager.setAdapter(mDemoCollectionPagerAdapter);
    }
}

// 因為這是一個對象集所以使用FragmentStatePagerAdapter,
// 而不是FragmentPagerAdapter.
public class DemoCollectionPagerAdapter extends FragmentStatePagerAdapter {
    public DemoCollectionPagerAdapter(FragmentManager fm) {
        super(fm);
    }

    @Override
    public Fragment getItem(int i) {
        Fragment fragment = new DemoObjectFragment();
        Bundle args = new Bundle();
        // 我們的對象只是一個整數 :-P
        args.putInt(DemoObjectFragment.ARG_OBJECT, i + 1);
        fragment.setArguments(args);
        return fragment;
    }

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

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

// 這個類的實例是一個代表了數據集中一個對象的fragment
public static class DemoObjectFragment extends Fragment {
    public static final String ARG_OBJECT = "object";

    @Override
    public View onCreateView(LayoutInflater inflater,
            ViewGroup container, Bundle savedInstanceState) {
        // 最後兩個參數保證LayoutParam能被正確填充
        View rootView = inflater.inflate(
                R.layout.fragment_collection_object, container, false);
        Bundle args = getArguments();
        ((TextView) rootView.findViewById(android.R.id.text1)).setText(
                Integer.toString(args.getInt(ARG_OBJECT)));
        return rootView;
    }
}

這個例子只顯示了創建swipe view的必要代碼。下面一節向你說明如何通過添加tab使導航更方便在頁面間切換。

添加Tab到Action Bar

Action bar tab能給用戶提供更熟悉的界面來在app的同級屏幕中切換和分辨。

使用ActionBar來創建tab,你需要啟用NAVIGATION_MODE_TABS,然後創建幾個ActionBar.Tab的實例,並對每個實例實現ActionBar.TabListener接口。例如在你的activity的onCreate()方法中,你可以使用與下面相似的代碼:

@Override
public void onCreate(Bundle savedInstanceState) {
    final ActionBar actionBar = getActionBar();
    ...

    // 指定在action bar中顯示tab.
    actionBar.setNavigationMode(ActionBar.NAVIGATION_MODE_TABS);

    // 創建一個tab listener,在用戶切換tab時調用.
    ActionBar.TabListener tabListener = new ActionBar.TabListener() {
        public void onTabSelected(ActionBar.Tab tab, FragmentTransaction ft) {
            // 顯示指定的tab
        }

        public void onTabUnselected(ActionBar.Tab tab, FragmentTransaction ft) {
            // 隱藏指定的tab
        }

        public void onTabReselected(ActionBar.Tab tab, FragmentTransaction ft) {
            // 可以忽略這個事件
        }
    };

    // 添加3個tab, 並指定tab的文字和TabListener
    for (int i = 0; i < 3; i++) {
        actionBar.addTab(
                actionBar.newTab()
                        .setText("Tab " + (i + 1))
                        .setTabListener(tabListener));
    }
}

根據你如何創建你的內容來處理ActionBar.TabListener回調改變tab。但是如果你是像上面那樣,通過ViewPager對每個tab使用fragment,下面這節就會說明當用戶選擇一個tab時如何切換頁面,當用戶劃屏切換頁面時如何更新相應頁面的tab。

使用Swipe View切換Tab

當用戶選擇tab時,在ViewPager中切換頁面,需要實現ActionBar.TabListener來調用在ViewPager中的setCurrentItem()來選擇相應的頁面:

@Override
public void onCreate(Bundle savedInstanceState) {
    ...

    // Create a tab listener that is called when the user changes tabs.
    ActionBar.TabListener tabListener = new ActionBar.TabListener() {
        public void onTabSelected(ActionBar.Tab tab, FragmentTransaction ft) {
            // 當tab被選中時, 切換到ViewPager中相應的頁面.
            mViewPager.setCurrentItem(tab.getPosition());
        }
        ...
    };
}

同樣的,當用戶通過觸屏手勢(touch gesture)切換頁面時,你也應該選擇相應的tab。你可以通過實現ViewPager.OnPageChangeListener接口來設置這個操作,當頁面變化時當前的tab也相應變化。例如:

@Override
public void onCreate(Bundle savedInstanceState) {
    ...

    mViewPager = (ViewPager) findViewById(R.id.pager);
    mViewPager.setOnPageChangeListener(
            new ViewPager.SimpleOnPageChangeListener() {
                @Override
                public void onPageSelected(int position) {
                    // 當劃屏切換頁面時,選擇相應的tab.
                    getActionBar().setSelectedNavigationItem(position);
                }
            });
    ...
}

使用標題欄替代Tab

如果你不想使用action bar tab,而想使用scrollable tabs來提供一個更簡短的可視化配置,你可以在swipe view中使用PagerTitleStrip

下面是一個內容為ViewPager,有一個PagerTitleStrip頂端對齊的activity的layout XML文件示例。單個頁面(adapter提供)佔據ViewPager中的剩餘空間。

<android.support.v4.view.ViewPager
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/pager"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <android.support.v4.view.PagerTitleStrip
        android:id="@+id/pager_title_strip"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_gravity="top"
        android:background="#33b5e5"
        android:textColor="#fff"
        android:paddingTop="4dp"
        android:paddingBottom="4dp" />

</android.support.v4.view.ViewPager>

书籍推荐