一、ViewPager概述

1、定义与用途：

• ViewPager是Android开发中用于实现页面滑动切换效果的一个重要组件。它允许用户通过左右滑动（或者根据自定义方向）来浏览不同的页面内容，这些页面内容通常是Fragment或者View。例如，在一个新闻应用中，可以使用ViewPager来展示不同分类的新闻，每个页面就是一个新闻分类的内容；在引导页、图片浏览等场景也经常会用到ViewPager。

2、所属框架与依赖：

• ViewPager属于Android的androidx.viewpager.widget包，在使用时需要在项目的build.gradle文件中添加相关依赖（如果是基于AndroidX），通常已经包含在大多数Android项目模板中。它与Fragment紧密结合，特别是在使用FragmentPagerAdapter或者FragmentStatePagerAdapter来管理页面内容时，能够很好地处理Fragment的生命周期和页面切换逻辑。

二、ViewPager的重要属性

1、adapter属性：

• 功能：这是ViewPager最重要的属性之一，用于关联一个PagerAdapter（如FragmentPagerAdapter、FragmentStatePagerAdapter或自定义的PagerAdapter）来提供页面内容。PagerAdapter负责创建和管理ViewPager中的页面，决定页面的数量、每个页面的内容以及页面的销毁和重建策略等。

FragmentPagerAdapter adapter = new FragmentPagerAdapter(getSupportFragmentManager()) {
   @Override
   public Fragment getItem(int position) {
       // 根据位置返回对应的Fragment，例如返回一个新闻详情Fragment
       return NewsFragment.newInstance(position);
   }
   @Override
   public int getCount() {
       // 返回页面数量，假设共有5个新闻分类
       return 5;
   }
};
viewPager.setAdapter(adapter);

2、offscreenPageLimit属性：

功能：用于设置在当前显示页面的两侧预加载的页面数量。预加载页面可以提高页面切换的流畅性，因为已经提前加载好的页面在切换时可以更快地显示。但同时，预加载过多的页面可能会占用更多的内存和资源，需要根据实际情况合理设置。

示例：

设置预加载相邻的两个页面，如
viewPager.setOffscreenPageLimit(2);。

计算预加载页面数量n-1，(默认是1，即预加载左右一个页面)

三、相关的适配器类（PagerAdapter及其子类）

1、FragmentPagerAdapter：

• 特点与用途：它是PagerAdapter的一个子类，主要用于在ViewPager中管理Fragment。它会在ViewPager的生命周期内保持Fragment的实例存活，适用于页面数量相对固定且每个Fragment的数据量不大的情况。例如，在一个简单的设置向导界面，有几个固定的步骤（页面），使用FragmentPagerAdapter可以很好地管理这些Fragment，并且由于页面数量固定，不会因为过多的Fragment实例而导致内存问题。
• 生命周期管理：当ViewPager初始化时，FragmentPagerAdapter会创建与ViewPager页面数量对应的Fragment实例（调用getItem方法），并且这些Fragment会一直保存在内存中，只有当ViewPager被销毁时才会销毁Fragment。

2、FragmentStatePagerAdapter：

• 特点与用途：
• 同样是用于管理Fragment的PagerAdapter子类，但与FragmentPagerAdapter不同的是，它会根据页面的显示状态来保存Fragment的状态。当页面不可见时，FragmentStatePagerAdapter会销毁Fragment视图，只保留Fragment的实例状态，这样可以有效地节省内存。适用于页面数量较多或者页面内容数据量较大的情况，如一个包含大量图片的图片浏览器应用，使用FragmentStatePagerAdapter可以避免同时加载过多的图片导致内存溢出。
• 生命周期管理：
• 当页面从可见变为不可见时，FragmentStatePagerAdapter会调用Fragment的onDestroyView方法来销毁视图，但Fragment的实例仍然存在。当页面再次变为可见时，会重新创建视图并恢复Fragment的状态。
• 示例：

private void initViewPage(){
    ViewPager viewPager = findViewById(R.id.view_pager);
	List<Fragment> fragmentList = new ArrayList<>();
	fragmentList.add(MyFragment.newInstance());
	fragmentList.add(AnotherFragment.newInstance());
	FragmentPagerAdapter adapter = new FragmentPagerAdapter(getSupportFragmentManager()) {
	    @Override
	    public Fragment getItem(int position) {
	        return fragmentList.get(position);
	    }
	    @Override
	    public int getCount() {
	        return fragmentList.size();
	    }
	};
	viewPager.setAdapter(adapter);
    // 页面切换事件
  viewPager.addOnPageChangeListener(new ViewPager.OnPageChangeListener() {
            @Override
            public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {
            }
            @Override
            public void onPageSelected(int position) {
                Fragment currentFragment = fragmentList.get(position);
                if (currentFragment instanceof DataTransferInterface) {
                    ((DataTransferInterface) currentFragment).onDataReceived("传递的数据");
                }
            }
            @Override
            public void onPageScrollStateChanged(int state) {
            }
        });
}

四、ViewPager的事件处理

1、页面切换事件：

• addOnPageChangeListener方法：
• 可以通过viewPager.addOnPageChangeListener方法添加一个OnPageChangeListener监听器来监听页面切换事件。这个监听器有三个主要的回调方法：onPageScrolled、onPageSelected和onPageScrollStateChanged。
• onPageScrolled方法：在页面滑动过程中会不断调用，用于获取页面滑动的进度等信息。例如，可以根据滑动进度来实现页面切换的动画效果，或者更新页面标题栏的透明度等操作。
• onPageSelected方法：当页面切换完成，新的页面被选中时调用。可以在这个方法中更新页面相关的指示器（如底部的小圆点指示器），或者加载新页面的数据等操作。
• onPageScrollStateChanged方法：用于监听页面滑动状态的变化，如从静止状态变为滑动状态，或者从滑动状态变为静止状态。可以根据这些状态变化来控制其他相关的操作，比如在页面滑动时暂停视频播放，页面静止时恢复播放等。

contentViewPager.addOnPageChangeListener(new ViewPager.OnPageChangeListener() {
 @Override
 public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {
     //在页面滑动过程中会不断调用，用于获取页面滑动的进度等信息。
 }
 @Override
 public void onPageSelected(int position) {
     //当页面切换完成，新的页面被选中时调用
 }
 @Override
 public void onPageScrollStateChanged(int state) {
     // 滚动完成，页面处于静止状态
     if (state == ViewPager.SCROLL_STATE_IDLE) {
         int iSelectTab = getBinding().contentViewPager.getCurrentItem();
         // 你的逻辑
     }
 }
});

2、触摸事件（与页面切换关联）：

• ViewPager本身会处理触摸事件来实现页面的滑动操作。如果需要自定义触摸行为，例如禁止某些方向的滑动或者添加特殊的触摸手势，可以通过继承ViewPager并覆盖onInterceptTouchEvent和onTouchEvent方法来实现。不过这种自定义操作需要谨慎处理，以免影响ViewPager的正常页面切换功能。
• PS：自定义一个禁止左右滑动的ViewPager：

public class NoScrollViewPager extends ViewPager {
        private boolean mCanScroll = false;
        public NoScrollViewPager(@NonNull Context context) {
            super(context);
        }
    
        public NoScrollViewPager(@NonNull Context context, @Nullable AttributeSet attrs) {
            super(context, attrs);
        }
        /**
         * @param canScroll true 可以左右滑动, false 禁止作用滑动
         */
        public void setCanScroll(boolean canScroll) {
            this.mCanScroll = canScroll;
        }
        @Override
        public boolean onInterceptTouchEvent(MotionEvent ev) {
            return mCanScroll;
        }
    
        @Override
        public boolean onTouchEvent(MotionEvent ev) {
            return mCanScroll;
        }
}

五、完整使用示例

• Fragment示例为单例模式，可以根据需求调整
• 简单传值可使用Bundle，多组件共享数据可使用ViewModel，需根据实际业务进行调整。

private void initViewPagerView() {
    MyFragment.newInstance().setIntent(mFltId, null);
    MyFragment2.newInstance().setIntent(mFltId, false);
    BaseFragment[] fragments = new BaseFragment[]{
            MyFragment.newInstance(),
            MyFragment2.newInstance(),
    };
    //重要：BEHAVIOR_SET_USER_VISIBLE_HINT, BEHAVIOR_RESUME_ONLY_CURRENT_FRAGMENT(表示只有当前 Fragment 可以走到 onResume-懒加载模式)
    FragmentAdapter<BaseFragment> mFragmentAdapter = new FragmentAdapter<>(getChildFragmentManager(), 1, fragments);
    mMainViewPager.setCanScroll(false);
    //非常重要不然会，切换是重新走生命周期
    mMainViewPager.setOffscreenPageLimit(2);
    mMainViewPager.setAdapter(mFragmentAdapter);
    mMainViewPager.setCurrentItem(0);
}

1、使用观察者试图加载完后自动切换到第一个item中。

mMainViewPager.getViewTreeObserver().addOnGlobalLayoutListener(new ViewTreeObserver.OnGlobalLayoutListener() {
    @Override
    public void onGlobalLayout() {
        mMainViewPager.getViewTreeObserver().removeOnGlobalLayoutListener(this);
        mMainViewPager.setCurrentItem(0);
    }
});