企业🤖AI智能体构建引擎,智能编排和调试,一键部署,支持私有化部署方案 广告
## 一、简介 **1.特点:**可以左右滑动的控件,需要PagerAdapter配合使用,由v4包提供 类全名: android.support.v4.view.ViewPager **2.作用**:ViewPager作用主要是能使界面左右滑动。比如最常用的使用是做一个引导界面;多张图片的预览或自动变换的图片展示(如淘宝首页面上的广告);viewpager还可以结合fragment作为主界面框架(如微信主界面)。。。 **3.viewpager中的几个重要的方法** 1)setAdapter()设置ViewPager的适配器。 2)setOnPageChangeListener()设置页面改变事件监听器 3)setCurrentItem(int position) 显示第几页 4)setCurrentItem(int position,boolean smoothScroll) 显示第几页,是否执行滚动动画 5)setOffscreenPageLimit(int limit) 设置脱离屏幕的页面限制--最多同时加载的页面数,limit默认是1 -这个方法解释一下:默认情况下,viewpager在显示页面时,会加载当前显示页和它左右的页面,这也是为什么移动页面时可以显示下一页面一部分。如果想设置其他数,viewpager会加载对应值的页面,比如设置2,则当前显示页和它左两页和右两页都会加载。 ## 二、相关类介绍 **1.viewpager相关的几个重要的类** **1.1OnPageChangeListener:** –onPageScrollStateChanged(int state) 页面滚动发生或停止时 –onPageScrolled(int position, float offset, int offsetPixes) 滚动时 –onPageSelected(int position) 页面位置确定时 **1.2 PagerAdapter** –作用:主要配合ViewPager显示相关的View –用法: 1)创建类,并继承PagerAdatper 2) 必须实现的方法 –getCount() 获取View的数量 –instantiateItem(ViewGroup, int poistion) 实例化指定位置的View对象 –destroyItem(ViewGroup, int poistion, Object) 删除指定位置的View –isViewFromObject(View, Object) 判断当前的View是否为Object **1.3FragmentPagerAdaper** –作用:与PagerAdapter的功能相同,不过显示的View改为Fragment –FragmentStatePagerAdapter: 如果需要处理有很多页,并且数据动态性较大、占用内存较多的情况,应该使用FragmentStatePagerAdapter 保存当前界面,以及下一个界面和上一个界面(如果有),最多保存3个,其他会被销毁掉。 –FragmentPagerAdaper和FragmentStatePagerAdapter的区别: FragmentPagerAdaper销毁的只是视图,数据没有销毁,FragmentStatePagerAdapter则是全部销毁。拿fragment生命周期来说,使用FragmentPagerAdaper,当滑动页面时,被销毁的fragment会执行到onDestyoyView()但没有执行onDestroy()。而使用FragmentStatePagerAdapter时,会执行onDestroy()方法。后面实例会看到。 ## 三、使用 **1.使用步骤:** 1) 在布局文件中使用标签 ~~~ <android.support.v4.view.ViewPager/> ~~~ 2) 代码中增加显示的页面 3) 在Activity里实例化ViewPager组件,并设置它的Adapter 需要注意的是:根据不同的场景,选择不同的适配器父类,不结合fragment使用时使用继承PagerAdapter的适配器,结合Fragment使用时,根据需求,可以选择父类为FragmentPagerAdapter和FragmentStatePagerAdapter,这两个的区别在后面前面已经讲过了。 **2.案例一:用viewpager做一个欢迎界面** 先看效果图: ![这里写图片描述](https://box.kancloud.cn/2016-04-20_5717152a6d732.jpg "") **1) 布局文件** ~~~ <FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="match_parent" tools:context="${relativePackage}.${activityClass}" > <!-- 其显示的页面需要通过PagerAdapter适配器增加或移除 --> <android.support.v4.view.ViewPager android:id="@+id/viewpager" android:layout_width="match_parent" android:layout_height="match_parent" /> <!-- 导航布局 ,小点点 --> <LinearLayout android:id="@+id/ll_dots" android:layout_width="match_parent" android:layout_height="wrap_content" android:layout_gravity="bottom" android:layout_marginBottom="10dp" android:gravity="center" android:orientation="horizontal" android:padding="10dp" > </LinearLayout> </FrameLayout> ~~~ **2) 然后看看几个主要的方法体:** **第一个是自定义的适配器**,各种方法都有注释。 ~~~ // 声明PageAdapter子类,用于管理viewpager中显示的控件 class WelComePageAdapter extends PagerAdapter { @Override public int getCount() { // TODO 返回页面的数量 return views.size(); } @Override public Object instantiateItem(ViewGroup container, int position) { // TODO 获取指定位置的View(UI),并增加到ViewPager中,同时作为当前页面的数据返回 Log.i("--", "instantiateItem--" + position); View view = views.get(position); container.addView(view); return view; } @Override public void destroyItem(ViewGroup container, int position, Object object) { // TODO 当前位置与VIewPager中显示页面的位置的间隔超出一页面,需要将当前位置的页面移除 Log.i("--", "destroyItem--" + position); container.removeView(views.get(position)); } @Override public boolean isViewFromObject(View view, Object obj) { // TODO 判断当前显示的页面的UI和数据对象是否一致 return view == obj; } } ~~~ **第二个是viewpager滑动监听事件**,这里自定义一个类看着清楚点,继承OnPageChangeListener,然后事项相应的方法,特别注意onPageScrolled和onPageSelected这两个方法,onPageScrolled在滑动时会一直回调,根据回调的三个参数,在这里可以进行相应的操作,比如微信那个,当你滑动时,相邻两个标签会有颜色的渐变,就在这里处理的。onPageSelected方法在滑动一个页面停止后回调。 ~~~ class WelcomPageChangeListner implements OnPageChangeListener { @Override public void onPageScrollStateChanged(int state) { Log.i("--", "onPageScrollStateChanged" + state); // TODO 页面滚动状态发生变化事件:开始滚动、停止滚动、正在设置页面 // ViewPager.SCROLL_STATE_DRAGGING 开始滚动 // ViewPager.SCROLL_STATE_IDLE 停止滚动 // ViewPager.SCROLL_STATE_SETTLING 正在设置页面,即将要停止,并且设置当前显示的页面 // setDot(position); // switch (state) { // case ViewPager.SCROLL_STATE_DRAGGING: // Log.i("--", "-SCROLL_STATE_DRAGGING-"); // break; // case ViewPager.SCROLL_STATE_IDLE: // Log.i("--", "-SCROLL_STATE_IDLE-"); // break; // case ViewPager.SCROLL_STATE_SETTLING: // Log.i("--", "-SCROLL_STATE_SETTLING-"); // break; // } } ~~~ ~~~ /** * 第一个参数:滚动页面开始的位置 <br> * 第二个参数:两个页面之间滚动的偏移量,范围:0-1<br> * 第三个页面:两个页面之间的滚动的像素偏移量<br> */ @Override public void onPageScrolled(int position, float offset, int offsetPixwls) { // TODO 从当前页面位置开始滚动事件 // Log.i("--", "-onPageScrolled-" + position + ",[" + offset + "]," // + "[" + offsetPixwls + "]"); } @Override public void onPageSelected(int position) { // TODO 指定位置的页面被选择 setDot(position); } } ~~~ **第三个是动态改变导航栏小点点的背景图。** ~~~ /** * 选择指定位置的导航图片为选择图片,之前选择的导航图片重置为未选择图片 * * @param position */ private void setDot(int position) { ImageView imageView = null; // 遍历导航布局张所有的子控件,判断子控件的位置是否未选择位置,若是则设置为选择图片 for (int i = 0; i < LlDot.getChildCount(); i++) { imageView = (ImageView) LlDot.getChildAt(i);// 获取布局中指定位置的子控件 if (i == position) { imageView.setImageResource(R.drawable.page_now); } else { imageView.setImageResource(R.drawable.page); } } } ~~~ 其他还有小点点的点击事件,具体看源代码。 **3.案例二:viewpager和view结合做一个主界面** 效果图: ![这里写图片描述](https://box.kancloud.cn/2016-04-23_571af4d4d8d7f.jpg "") 1)布局:最上面的导航栏是一个HorizonalScrollView,里面有一个LinearLayout(因为HorizonalScrollView里只能有一个子视图),然后在LinearLayout定义你想要的导航模块,TextView即可。 ~~~ <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="match_parent" tools:context="${relativePackage}.${activityClass}" > <HorizontalScrollView android:id="@+id/hScrollView" android:layout_width="match_parent" android:layout_height="50dp" android:layout_marginBottom="2dp" android:scrollbars="none" > <LinearLayout android:layout_width="wrap_content" android:layout_height="match_parent" android:orientation="vertical" > <!-- 顶部模块的布局 --> <LinearLayout android:id="@+id/navLayout" android:layout_width="wrap_content" android:layout_height="45dp" android:orientation="horizontal" > <TextView android:id="@+id/tv_model1" android:layout_width="150dp" android:layout_height="match_parent" android:gravity="center" android:text="第一" android:textColor="#000" android:textSize="20sp" /> <TextView android:id="@+id/tv_model2" android:layout_width="150dp" android:layout_height="match_parent" android:gravity="center" android:text="第二" android:textColor="#000" android:textSize="20sp" /> <TextView android:id="@+id/tv_model3" android:layout_width="150dp" android:layout_height="match_parent" android:gravity="center" android:text="第三" android:textColor="#000" android:textSize="20sp" /> <TextView android:id="@+id/tv_model4" android:layout_width="150dp" android:layout_height="match_parent" android:gravity="center" android:text="第四" android:textColor="#000" android:textSize="20sp" /> <TextView android:id="@+id/tv_model5" android:layout_width="150dp" android:layout_height="match_parent" android:gravity="center" android:text="第五" android:textColor="#000" android:textSize="20sp" /> </LinearLayout> <!-- 指示器控件 --> <View android:id="@+id/view_nav" android:layout_width="150dp" android:layout_height="4dp" android:background="#0cf" /> <!-- 基准线 --> <View android:layout_width="match_parent" android:layout_height="1dp" android:background="#0cf" /> </LinearLayout> </HorizontalScrollView> <android.support.v4.view.ViewPager android:id="@+id/viewPager" android:layout_below="@id/hScrollView" android:layout_width="match_parent" android:layout_height="match_parent" /> </RelativeLayout> ~~~ **还需要几个fragment页,这里只展示一个,其他类似:** ~~~ <?xml version="1.0" encoding="utf-8"?> <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="vertical" android:gravity="center" android:background="#80f0"> <TextView android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="第一个页面" android:textSize="30sp" /> </RelativeLayout> ~~~ **2)代码中需要做的事情有:** 2).1 指示器的移动,也就是模块下那个粗线条的移动,viewpager本身就是可滑动的控件,这里需要指示器随着手指的滑动进行滑动 2).2选择导航模块的位置,将水平滚动到当前模块位置的中心点, 2).3模块点击事件,点击模块,显示相应的page 那么来一步步实现上面的工作: 2.1指示器的移动 要求是指示器随着手指的滑动,起始也就是动态的改变指示器的leftMargin ~~~ /** * 指示器移动 * @param position * @param offset */ private void navIndicateMove(int position, float offset){ int leftMargin = (int) (indicateParams.width * (position + offset)); indicateParams.leftMargin = leftMargin; navIndicate.setLayoutParams(indicateParams); } ~~~ 2.2选择导航模块的位置,将水平滚动到当前模块位置的中心点 因为整个导航模块都在一个HorizonalScrollView中,HorizonalScrollView中有两个方法可以指定的移动位置,一个是**hScrollView.scrollTo(x, y);//非平滑移动** **hScrollView.smoothScrollTo(x, y);//平滑移动** 所以根据选择的模块得到移动值即可。 ~~~ /** * 选择导航模块的位置,将水平滚动到当前模块位置的中心点 * * @param position */ private void selectNav(int position) { TextView modelTv = (TextView) navLayout.getChildAt(position); int left = modelTv.getLeft();// 获取当前控件的左边位置 // 怎么放到中间? // int scWidth = (getResources().getDisplayMetrics().widthPixels / 2); int offset = left - (getResources().getDisplayMetrics().widthPixels / 2) + modelTv.getWidth() / 2; hScrollView.smoothScrollTo(offset, 0);// 水平滚动到指定位置 //设置被选中的模块 for(int i = 0; i < navLayout.getChildCount(); i++){ modelTv = (TextView) navLayout.getChildAt(i); if(i == position){ modelTv.setTextColor(Color.argb(100, 255, 0, 0)); }else{ modelTv.setTextColor(Color.argb(255, 0, 0, 0)); } } } ~~~ **3.模块点击事件,点击模块,显示相应的page** 给每个模块添加点击事件,然后点击一个模块,只用调用viewPager的 viewPager.setCurrentItem(item);//非平滑滑动 viewPager.setCurrentItem(item, smoothScroll);//平滑滑动 ~~~ /** * 模块点击事件 */ private void modelTvClickEvent() { for(int i = 0; i < navLayout.getChildCount(); i++){ final TextView tv = (TextView) navLayout.getChildAt(i); tv.setTag(i); tv.setOnClickListener(new OnClickListener() { @Override public void onClick(View v) { int position = (Integer)tv.getTag(); // selectNav(position); // navIndicateMove(position, 0); viewPager.setCurrentItem(position, true); } }); } } ~~~ **这样,viewpager结合导航栏都可以同步滑动了。** **4.案例三:viewpager和fragment结合做一个主界面** 效果图: ![这里写图片描述](https://box.kancloud.cn/2016-04-23_571af4d52e586.jpg "") 结合fragment使用和结合view使用很相似,只是继承的适配器不同。 上面继承PagerAdapter,这里继承FragmentPagerAdapter或者FragmentStatePagerAdapter。 1)定义一个ListFragment 2)自定义适配器 3)初始化数据源 ListFragment的使用前面有一篇讲过,这里就不附代码了。 来看看自定义适配器:很简单就完事 ~~~ class InfoFragmentAdapter extends FragmentStatePagerAdapter{ public InfoFragmentAdapter(FragmentManager fm){ super(fm); } @Override public int getCount() { return fragments.size(); } @Override public Fragment getItem(int position) { //返回指定位置的碎片 return fragments.get(position); } } ~~~ **最后可以借这个案例看一看FragmentPagerAdapter和FragmentStatePagerAdapter区别:** ViewPager:默认创建自己和左右两页,当某个页面与显示的页面间放大点隔大于1,则销毁UI界面(注意,只是UI,里面的数据则不会销毁) FragmentPagerAdapter:管理fragment时销毁的是UI界面,(fragment生命周期只会执行到onDestroyView) FragmentStatePagerAdapter:管理fragment时,完全销毁(fragment生命周期会执行onDestroy) 只用把自定义适配器类的父类改一改,然后看fragment各生命周期 打印的日志即可看到区别,这里不做演示了。 现在,结合案例二和案例三就可以做一个现在很流行的主界面了。 [ 源码下载](http://download.csdn.net/detail/u011102153/9120819)