使用片段的基本 ViewPager

ViewPager 允许在活动中显示多个片段,可以通过向左或向右滑动来导航。ViewPager 需要使用 PagerAdapter 来提供视图或片段。

然而,在使用片段 FragmentPagerAdapterFragmentStatePagerAdapter 的情况下,你会发现两个更具体的实现。当片段第一次需要实例化时,将为每个需要实例化的位置调用 getItem(position)getCount() 方法将返回总页数,以便 ViewPager 知道需要显示多少片段。

FragmentPagerAdapterFragmentStatePagerAdapter 都保留了 ViewPager 需要显示的片段的缓存。默认情况下,ViewPager 将尝试存储最多 3 个与当前可见片段对应的片段,以及右侧和左侧旁边的片段。此外,FragmentStatePagerAdapter 将保持每个片段的状态。

请注意,这两个实现都假设你的片段将保留其位置,因此如果你保留片段列表而不是静态数量,如 getItem() 方法中所示,你将需要创建 PagerAdapter 的子类并覆盖至少 instantiateItem()destroyItem()getItemPosition()methods。

只需在布局中添加 ViewPager,如基本示例中所述

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout> 
    <android.support.v4.view.ViewPager
        android:id="@+id/vpPager"> 
    </android.support.v4.view.ViewPager>
</LinearLayout>

然后定义适配器,该适配器将确定存在多少页面以及为适配器的每个页面显示哪个片段。

public class MyViewPagerActivity extends AppCompatActivity {
    private static final String TAG = MyViewPagerActivity.class.getName();

    private MyPagerAdapter mFragmentAdapter;
    private ViewPager mViewPager;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);    
        setContentView(R.layout.myActivityLayout);

        //Apply the Adapter
        mFragmentAdapter = new MyPagerAdapter(getSupportFragmentManager());    
        mViewPager = (ViewPager) findViewById(R.id.view_pager);
        mViewPager.setAdapter(mFragmentAdapter);
    }

    private class MyPagerAdapter extends FragmentPagerAdapter{

        public MyPagerAdapter(FragmentManager supportFragmentManager) {
            super(supportFragmentManager);
        }

        // Returns the fragment to display for that page
        @Override
        public Fragment getItem(int position) {
            switch(position) {
                case 0:
                    return new Fragment1();

                case 1:
                    return new Fragment2();

                case 2:
                    return new Fragment3();

                default:
                    return null;
            }
        }

        // Returns total number of pages    
        @Override
        public int getCount() {
            return 3;
        }

    }
}

Version >= 3.2.x 中

如果你使用 android.app.Fragment,则必须添加此依赖项:

compile 'com.android.support:support-v13:25.3.1'

如果你使用 android.support.v4.app.Fragment,则必须添加此依赖项:

compile 'com.android.support:support-fragment:25.3.1'