使用ViewPager实现屏幕滑动

编写:XizhiXu - 原文:http://developer.android.com/training/animation/screen-slide.html

屏幕划动是在两个完整界面间的转换,它在一些UI中很常见,比如设置向导和幻灯放映。这节课将告诉你怎样通过support library提供的ViewPager实现屏幕滑动。ViewPager能自动实现屏幕滑动动画。下面展示了从一个内容界面到一下界面的屏幕滑动转换是什么样子的。





如果你想直接查看整个例子,下载并运行App样例然后选择屏幕滑动例子。查看下列文件中的代码实现:

  • src/ScreenSlidePageFragment.java
  • src/ScreenSlideActivity.java
  • layout/activity_screen_slide.xml
  • layout/fragment_screen_slide_page.xml

创建View

创建Fragment所使用的布局文件。下面的例子包含一个显示文本的TextView:

  1. <!-- fragment_screen_slide_page.xml -->
  2. <ScrollView xmlns:android="http://schemas.android.com/apk/res/android"
  3. android:id="@+id/content"
  4. android:layout_width="match_parent"
  5. android:layout_height="match_parent" >
  6. <TextView style="?android:textAppearanceMedium"
  7. android:padding="16dp"
  8. android:lineSpacingMultiplier="1.2"
  9. android:layout_width="match_parent"
  10. android:layout_height="wrap_content"
  11. android:text="@string/lorem_ipsum" />
  12. </ScrollView>

与此同时我们还定义了一个字符串作为该Fragment的内容。

创建Fragment

创建一个 Fragment 子类,它从 onCreateView() 方法中返回之前创建的布局。无论何时如果我们需要为用户展示一个新的页面,可以在它的父Activity中创建该Fragment的实例:

  1. import android.support.v4.app.Fragment;
  2. ...
  3. public class ScreenSlidePageFragment extends Fragment {
  4. @Override
  5. public View onCreateView(LayoutInflater inflater, ViewGroup container,
  6. Bundle savedInstanceState) {
  7. ViewGroup rootView = (ViewGroup) inflater.inflate(
  8. R.layout.fragment_screen_slide_page, container, false);
  9. return rootView;
  10. }
  11. }

添加ViewPager

ViewPager 有内建的滑动手势用来在页面间转换,并且它默认使用滑屏动画,所以我们不用自己为其创建。ViewPager使用PagerAdapter来补充新页面,所以PagerAdapter会用到你之前新建的Fragment类。

开始之前,创建一个包含ViewPager的布局:

  1. <!-- activity_screen_slide.xml -->
  2. <android.support.v4.view.ViewPager
  3. xmlns:android="http://schemas.android.com/apk/res/android"
  4. android:id="@+id/pager"
  5. android:layout_width="match_parent"
  6. android:layout_height="match_parent" />

创建一个Activity来做下面这些事情:

  • 把ContentView设置成这个包含ViewPager的布局。

  • 创建一个继承自FragmentStatePagerAdapter抽象类的类,然后实现getItem()方法来把ScreenSlidePageFragment实例作为新页面补充进来。PagerAdapter还需要实现getCount()方法,它返回 Adapter将要创建页面的总数(例如5个)。

  • PagerAdapterViewPager关联起来。

  • 处理Back按钮,按下变为在虚拟的Fragment栈中回退。如果用户已经在第一个页面了,则在Activity的回退栈(back stack)中回退。

  1. import android.support.v4.app.Fragment;
  2. import android.support.v4.app.FragmentManager;
  3. ...
  4. public class ScreenSlidePagerActivity extends FragmentActivity {
  5. /**
  6. * The number of pages (wizard steps) to show in this demo.
  7. */
  8. private static final int NUM_PAGES = 5;
  9. /**
  10. * The pager widget, which handles animation and allows swiping horizontally to access previous
  11. * and next wizard steps.
  12. */
  13. private ViewPager mPager;
  14. /**
  15. * The pager adapter, which provides the pages to the view pager widget.
  16. */
  17. private PagerAdapter mPagerAdapter;
  18. @Override
  19. protected void onCreate(Bundle savedInstanceState) {
  20. super.onCreate(savedInstanceState);
  21. setContentView(R.layout.activity_screen_slide);
  22. // Instantiate a ViewPager and a PagerAdapter.
  23. mPager = (ViewPager) findViewById(R.id.pager);
  24. mPagerAdapter = new ScreenSlidePagerAdapter(getSupportFragmentManager());
  25. mPager.setAdapter(mPagerAdapter);
  26. }
  27. @Override
  28. public void onBackPressed() {
  29. if (mPager.getCurrentItem() == 0) {
  30. // If the user is currently looking at the first step, allow the system to handle the
  31. // Back button. This calls finish() on this activity and pops the back stack.
  32. super.onBackPressed();
  33. } else {
  34. // Otherwise, select the previous step.
  35. mPager.setCurrentItem(mPager.getCurrentItem() - 1);
  36. }
  37. }
  38. /**
  39. * A simple pager adapter that represents 5 ScreenSlidePageFragment objects, in
  40. * sequence.
  41. */
  42. private class ScreenSlidePagerAdapter extends FragmentStatePagerAdapter {
  43. public ScreenSlidePagerAdapter(FragmentManager fm) {
  44. super(fm);
  45. }
  46. @Override
  47. public Fragment getItem(int position) {
  48. return new ScreenSlidePageFragment();
  49. }
  50. @Override
  51. public int getCount() {
  52. return NUM_PAGES;
  53. }
  54. }
  55. }

用PageTransformer自定义动画

要展示不同于默认滑屏效果的动画,我们需要实现ViewPager.PageTransformer接口,然后把它补充到ViewPager里就行了。这个接口只暴露了一个方法,transformPage()。每次界面切换,这个方法都会为每个可见页面(通常只有一个页面可见)和刚消失的相邻页面调用一次。例如,第三页可见而且用户向第四页拖动,transformPage()在操作的各个阶段为第二,三,四页分别调用。

transformPage()的实现中,基于当前屏幕显示的页面的positionpositiontransformPage()方法的参数给出)决定哪些页面需要被动画转换,这样我们就能创建自己的动画。

position参数表示特定页面相对于屏幕中的页面的位置。它的值在用户滑动页面过程中动态变化。当某一页面填充屏幕,它的值为0。当页面刚向屏幕右侧方向被拖走,它的值为1。如果用户在页面1和页面2间滑动到一半,那么页面1的position为-0.5并且页面2的position为 0.5。根据屏幕上页面的position,我们可以通过setAlpha()setTranslationX()setScaleY()这些方法设定页面属性来自定义滑动动画。

当我们实现了PageTransformer后,用我们的实现调用setPageTransformer()来应用这些自定义动画。例如,如果我们有一个叫做ZoomOutPageTransformerPageTransformer,可以这样设置自定义动画:

  1. ViewPager mPager = (ViewPager) findViewById(R.id.pager);
  2. ...
  3. mPager.setPageTransformer(true, new ZoomOutPageTransformer());

详情查看Zoom-out Page TransformerDepth Page Transformer部分的 PageTransformer视频和例子。

Zoom-out Page Transformer

当在相邻界面滑动时,这个Page Transformer使页面收缩并褪色。当页面越靠近中心,它将渐渐还原到正常大小并且图像渐入。





  1. public class ZoomOutPageTransformer implements ViewPager.PageTransformer {
  2. private static final float MIN_SCALE = 0.85f;
  3. private static final float MIN_ALPHA = 0.5f;
  4. public void transformPage(View view, float position) {
  5. int pageWidth = view.getWidth();
  6. int pageHeight = view.getHeight();
  7. if (position < -1) { // [-Infinity,-1)
  8. // This page is way off-screen to the left.
  9. view.setAlpha(0);
  10. } else if (position <= 1) { // [-1,1]
  11. // Modify the default slide transition to shrink the page as well
  12. float scaleFactor = Math.max(MIN_SCALE, 1 - Math.abs(position));
  13. float vertMargin = pageHeight * (1 - scaleFactor) / 2;
  14. float horzMargin = pageWidth * (1 - scaleFactor) / 2;
  15. if (position < 0) {
  16. view.setTranslationX(horzMargin - vertMargin / 2);
  17. } else {
  18. view.setTranslationX(-horzMargin + vertMargin / 2);
  19. }
  20. // Scale the page down (between MIN_SCALE and 1)
  21. view.setScaleX(scaleFactor);
  22. view.setScaleY(scaleFactor);
  23. // Fade the page relative to its size.
  24. view.setAlpha(MIN_ALPHA +
  25. (scaleFactor - MIN_SCALE) /
  26. (1 - MIN_SCALE) * (1 - MIN_ALPHA));
  27. } else { // (1,+Infinity]
  28. // This page is way off-screen to the right.
  29. view.setAlpha(0);
  30. }
  31. }
  32. }

Depth Page Transformer

这个Page Transformer使用默认动画的屏幕左滑动画。但是为右滑使用一种“潜藏”效果的动画。潜藏动画将page淡出,并且线性缩小它。





注意:在潜藏过程中,默认动画(屏幕滑动)是仍旧发生的,所以你必须用负的X平移来抵消它。例如:

view.setTranslationX(-1 * view.getWidth() * position);

下面的例子展示了如何抵消默认滑屏动画:

public class DepthPageTransformer implements ViewPager.PageTransformer {
    private static final float MIN_SCALE = 0.75f;

    public void transformPage(View view, float position) {
        int pageWidth = view.getWidth();

        if (position < -1) { // [-Infinity,-1)
            // This page is way off-screen to the left.
            view.setAlpha(0);

        } else if (position <= 0) { // [-1,0]
            // Use the default slide transition when moving to the left page
            view.setAlpha(1);
            view.setTranslationX(0);
            view.setScaleX(1);
            view.setScaleY(1);

        } else if (position <= 1) { // (0,1]
            // Fade the page out.
            view.setAlpha(1 - position);

            // Counteract the default slide transition
            view.setTranslationX(pageWidth * -position);

            // Scale the page down (between MIN_SCALE and 1)
            float scaleFactor = MIN_SCALE
                    + (1 - MIN_SCALE) * (1 - Math.abs(position));
            view.setScaleX(scaleFactor);
            view.setScaleY(scaleFactor);

        } else { // (1,+Infinity]
            // This page is way off-screen to the right.
            view.setAlpha(0);
        }
    }
}