【Android】ViewPager基本用法总结

ViewPager 是 Android 中一个用于在同一屏幕上滑动不同页面（通常是左右滑动）的组件。它通常用于实现多页面滑动效果，好比应用的引导页、图片轮播、以及支持标签导航的界面。
  ViewPager 与 PagerAdapter 联合使用。PagerAdapter 是一个适配器，它负责为 ViewPager 提供页面内容。每个页面通常是一个 Fragment，也可以是一个普通的 View。
   特点：
  

• 滑动效果：ViewPager 答应用户通过滑动手势在不同页面之间切换。
  
• 缓存页面：默认环境下，ViewPager 会缓存当前页面的前一页和后一页，以进步 滑动性能。
  
• 与TabLayout联合：ViewPager 经常与 TabLayout 配合使用，实现顶部标签栏导航。
  

  一、添加ViewPager控件

1. <?xml version="1.0" encoding="utf-8"?>
2. <androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
3.     xmlns:app="http://schemas.android.com/apk/res-auto"
4.     xmlns:tools="http://schemas.android.com/tools"
5.     android:id="@+id/main"
6.     android:layout_width="match_parent"
7.     android:layout_height="match_parent"
8.     tools:context=".MainActivity">
10.     <androidx.viewpager.widget.ViewPager
11.         android:id="@+id/viewPager"
12.         android:layout_width="match_parent"
13.         android:layout_height="match_parent" />
15. </androidx.constraintlayout.widget.ConstraintLayout>

复制代码

二、构建适配器类

继承PagerAdapter并实现4个方法：
getCount，destroyItem，instantiateItem，isViewFromObject

1. public class MyViewPagerAdapter extends PagerAdapter {
3.     @Override
4.     public int getCount() {
5.         return 0;
6.     }
8.     @Override
9.     public void destroyItem(@NonNull View container, int position, @NonNull Object object) {
10.         super.destroyItem(container, position, object);
11.     }
13.     @NonNull
14.     @Override
15.     public Object instantiateItem(@NonNull View container, int position) {
16.         return super.instantiateItem(container, position);
17.     }
19.     @Override
20.     public boolean isViewFromObject(@NonNull View view, @NonNull Object object) {
21.         return false;
22.     }
23. }

复制代码

三、在 MainActivity 中设置适配器

示例一：图片切换

适配器

1. public class MyViewPagerAdapter extends PagerAdapter {
2.     List<ImageView> mImageViewList;
4.     public MyViewPagerAdapter(List<ImageView> mImageViewList) {
5.         this.mImageViewList = mImageViewList;
6.     }
8.     @Override
9.     public int getCount() {
10.         return mImageViewList == null ? 0 : mImageViewList.size();
11.     }
14.     @Override
15.     public boolean isViewFromObject(@NonNull View view, @NonNull Object object) {
16.         return view == object;
17.     }
19.     @NonNull
20.     @Override
21.     public Object instantiateItem(@NonNull ViewGroup container, int position) {
22.         container.addView(mImageViewList.get(position));
23.         return mImageViewList.get(position);
24.     }
26.     // 该方法需删除super方法，否则会报错闪退
27.     @Override
28.     public void destroyItem(@NonNull ViewGroup container, int position, @NonNull Object object) {
29.         container.removeView((View) object);
30.     }
31. }

复制代码

MainActivity

1. public class MainActivity extends AppCompatActivity {
2.     private MyViewPagerAdapter myViewPagerAdapter;
3.     private ViewPager viewPager;
4.     List<ImageView> imageViewsList;
6.     @Override
7.     protected void onCreate(@Nullable Bundle savedInstanceState) {
8.         super.onCreate(savedInstanceState);
9.         setContentView(R.layout.activity_main);
11.         viewPager = findViewById(R.id.viewPager);
13.         initData();
14.         myViewPagerAdapter = new MyViewPagerAdapter(imageViewsList);
15.         viewPager.setAdapter(myViewPagerAdapter);
16.         viewPager.addOnPageChangeListener(new ViewPager.OnPageChangeListener() {
17.             @Override
18.             public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {
20.             }
22.             @Override
23.             public void onPageSelected(int position) {
24.                 Toast.makeText(MainActivity.this, "当前页面为：" + (position + 1), Toast.LENGTH_SHORT).show();
25.             }
27.             @Override
28.             public void onPageScrollStateChanged(int state) {
30.             }
31.         });
32.     }
34.     private void initData() {
35.         ImageView imageView1 = new ImageView(this);
36.         imageView1.setImageResource(R.drawable.p1);
37.         ImageView imageView2 = new ImageView(this);
38.         imageView2.setImageResource(R.drawable.p2);
39.         ImageView imageView3 = new ImageView(this);
40.         imageView3.setImageResource(R.drawable.p3);
42.         imageViewsList = new ArrayList<>();
43.         imageViewsList.add(imageView1);
44.         imageViewsList.add(imageView2);
45.         imageViewsList.add(imageView3);
46.     }
47. }

复制代码

示例二：Fragment切换

适配器

与图片类似，List存储的为Fragment，并且自界说适配器类继承FragmentPagerAdapter
只用实现两个方法getItem，getCount

1. public class MyFragmentVPAdapter extends FragmentPagerAdapter {
2.     List<Fragment> myFragmentList;
4.     public MyFragmentVPAdapter(@NonNull FragmentManager fm, List<Fragment> fragmentList) {
5.         super(fm);
6.         this.myFragmentList = fragmentList;
7.     }
9.     @NonNull
10.     @Override
11.     public Fragment getItem(int position) {
12.         return myFragmentList == null ? null : myFragmentList.get(position);
13.     }
15.     @Override
16.     public int getCount() {
17.         return myFragmentList == null ? 0 : myFragmentList.size();
18.     }
19. }

复制代码

Fragment

这里省略部门代码和fragment的layout，只放了一个TextView
这里通过param1参数传递信息来设置fragment样式

1. public class VPFragment extends Fragment {
3.     private static final String ARG_PARAM1 = "param1";
4.     private static final String ARG_PARAM2 = "param2";
6.     private String mParam1;
7.     private String mParam2;
9.     private TextView textView;
10.    
11.     public static VPFragment newInstance(String param1, String param2) {
12.         VPFragment fragment = new VPFragment();
13.         Bundle args = new Bundle();
14.         args.putString(ARG_PARAM1, param1);
15.         args.putString(ARG_PARAM2, param2);
16.         fragment.setArguments(args);
17.         return fragment;
18.     }
20.     @Override
21.     public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
22.         super.onViewCreated(view, savedInstanceState);
23.         
24.         textView = view.findViewById(R.id.tv);
25.         textView.setText(mParam1);
26.     }
27. }

复制代码

MainActivity

1. public class MainActivity extends AppCompatActivity {
2.     // 声明 ViewPager 和自定义 Fragment 适配器
3.     private ViewPager viewPager;
4.     private MyFragmentVPAdapter mFragmentVPAdapter;
5.     List<Fragment> mFragmentList; // 存储 Fragment 的列表
7.     @Override
8.     protected void onCreate(Bundle savedInstanceState) {
9.         super.onCreate(savedInstanceState);
10.         setContentView(R.layout.activity_main);
12.         // 绑定布局文件中的 ViewPager 控件
13.         viewPager = findViewById(R.id.viewPager);
15.         // 初始化 Fragment 数据
16.         initData();
18.         // 创建适配器实例并将其设置给 ViewPager
19.         mFragmentVPAdapter = new MyFragmentVPAdapter(getSupportFragmentManager(), mFragmentList);
20.         viewPager.setAdapter(mFragmentVPAdapter);
22.         // 为 ViewPager 添加页面变化监听器
23.         viewPager.addOnPageChangeListener(new ViewPager.OnPageChangeListener() {
24.             @Override
25.             public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {
26.                 // 当页面正在滑动时调用，可以获取滑动的进度
27.             }
29.             @Override
30.             public void onPageSelected(int position) {
31.                 // 当新页面被选中时调用，显示当前页面索引的 Toast
32.                 Toast.makeText(MainActivity.this, "这是碎片" + (position + 1), Toast.LENGTH_SHORT).show();
33.             }
35.             @Override
36.             public void onPageScrollStateChanged(int state) {
37.                 // 当页面滑动状态改变时调用，比如静止、拖动、自动滑动状态
38.             }
39.         });
40.     }
42.     // 初始化 Fragment 列表的方法
43.     private void initData() {
44.         mFragmentList = new ArrayList<>(); // 创建一个存储 Fragment 的列表
46.         // 创建并初始化多个 VPFragment 实例，每个 Fragment 对应一个页面
47.         VPFragment vpFragment1 = VPFragment.newInstance("这是碎片1", "");
48.         VPFragment vpFragment2 = VPFragment.newInstance("这是碎片2", "");
49.         VPFragment vpFragment3 = VPFragment.newInstance("这是碎片3", "");
51.         // 将 Fragment 添加到列表中
52.         mFragmentList.add(vpFragment1);
53.         mFragmentList.add(vpFragment2);
54.         mFragmentList.add(vpFragment3);
55.     }
56. }

复制代码

---

---

感谢您的阅读
如有错误烦请指正

---

   参考：
  

• 36.3-ViewPager联合Fragment_哔哩哔哩_bilibili
  

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。