一、定义
ViewPager是android扩展包v4包中的类
android.support.v4.view.ViewPager
二、作用
左右切换当前的view,实现滑动切换的效果。
在使用这个类之前,必须明白:
- ViewPager类直接继承了ViewGroup类,和LinearLayout等布局一样,都是一个容器,需要在里面添加我们想要显示的内容。
- ViewPager类需要PagerAdapter适配器类提供数据,与ListView类似
三、使用
建立ViewPage的步骤:
3.1 XML布局
在XML布局中加入android.support.v4.view.ViewPager:
<android.support.v4.view.ViewPager
android:id="@+id/pager"
android:layout_width="match_parent"
android:layout_height="0dp"
android:layout_weight="1" />
3.2 配置数据源
当需要加载的页卡是View时:
LayoutInflater lf = getLayoutInflater().from(this);
view1 = lf.inflate(R.layout.layout1, null);
view2 = lf.inflate(R.layout.layout2, null);
view3 = lf.inflate(R.layout.layout3, null);
viewList = new ArrayList<View>();// 将要分页显示的View装入数组中
viewList.add(view1);
viewList.add(view2);
viewList.add(view3);
当需要加载的页卡是Fragment时:
Fragment1 fragment1 = new Fragment1();
Fragment2 fragment2 = new Fragment2();
Fragment3 fragment3 = new Fragment3();
Fragment4 fragment4 = new Fragment4();
// 将要分页显示的View装入数组中
List<Fragment> list = new ArrayList<Fragment>();
list.add(fragment1);
list.add(fragment2);
list.add(fragment3);
list.add(fragment4);
3.3 创建适配器
更详细的解释清参看:(4.3.1.13.2)为什么调用 FragmentPagerAdapter.notifyDataSetChanged() 并不能更新其 Fragment?
- 用相应的适配器Adapter关联上面的页卡(View/Fragment)和ViewPager
- PagerAdapter 数据源:List
- FragmentPagerAdapter 数据源:List
- FragmentStatePagerAdapter 数据源:List
写一个继承相应Adapter的类,然后根据需求重写方法,有几个方法是必须重写的
- 当页卡是View时:用ViewPagerAdapter:
public class MyViewPagerAdapter extends PagerAdapter{
private List<View> mListViews;
public MyViewPagerAdapter(List<View> mListViews) {
this.mListViews = mListViews;//构造方法,参数是我们的页卡,这样比较方便。
}
//直接继承PagerAdapter,至少必须重写下面的四个方法,否则会报错
@Override
public void destroyItem(ViewGroup container, int position, Object object) {
container.removeView(mListViews.get(position));//删除页卡
}
@Override
public Object instantiateItem(ViewGroup container, int position){
//这个方法用来实例化页卡
container.addView(mListViews.get(position), 0);//添加页卡
return mListViews.get(position);
}
@Override
public int getCount() {
return mListViews.size();//返回页卡的数量
}
@Override
public boolean isViewFromObject(View arg0, Object arg1) {
return arg0==arg1;//官方提示这样写
}
}
- 当页卡是Fragment时:用FragmentAdapter:
import android.support.v4.app.Fragment;
import android.support.v4.app.FragmentManager;
import android.support.v4.app.FragmentPagerAdapter;
public class MyFragmentAdapter extends FragmentPagerAdapter {
List<Fragment> list;
public MyFragmentAdapter(FragmentManager fm) {
super(fm);
}
public MyFragmentAdapter(FragmentManager fm,List<Fragment> list) {
super(fm);
this.list=list;
}//写构造方法,方便赋值调用
@Override
public Fragment getItem(int arg0) {
return list.get(arg0);
}//根据Item的位置返回对应位置的Fragment,绑定item和Fragment
@Override
public int getCount() {
return list.size();
}//设置Item的数量
}
3.3.1 FragmentStatePagerAdapter 和 FragmentPagerAdapter 的异同:
- 同
- PageAdapter 是 FragmentPagerAdapter 以及
FragmentStatePagerAdapter 的基类,可将上面的FragmentPagerAdapter 替换成FragmentStatePagerAdapter - 异
- FragmentPagerAdapter使用时,每一个生成的 Fragment 都将保存在内存之中,而 FragmentStatePagerAdapter 只保留了当前显示的Fragment,其他划过的Fragment离开视线后,就会被销毁;而在页面需要显示时,再生成新的实例
即当拥有大量的页面时,使用FragmentStatePagerAdapter不必在内存中占用大量的内存
3.4 在Activity里绑定Adapter
- ViewPagerAdapter:
private ViewPager viewPager;
viewPager.setAdapter(new MyViewPagerAdapter(views));
viewPager.setCurrentItem(0);
viewPager.setOnPageChangeListener(new MyOnPageChangeListener());//设置页面切换时候的监听器(可选,用了之后要重写它的回调方法处理页面切换时候的事务)
- FragmentPagerAdapter:
vp.addOnPageChangeListener(this);//设置页面切换时的监听器(可选,用了之后要重写它的回调方法处理页面切换时候的事务)
vp.setAdapter(new MyFragmentAdapter(getSupportFragmentManager(), list)
3.5 设置切换、滑动动画
利用Viewpage自带的方法setPageTransformer()可用于设置切换动画
- 步骤1:先定义动画效果类(此处采用Google官方给出的动画类)
DepthPageTransformer.java
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);
}
}
}
- 步骤2:动画方法方法调用
mViewPager.setPageTransformer(true, new DepthPageTransformer());
当然,你也可以自定义切换动画的效果,具体请点击这里PageTransformer实现个性的ViewPager切换动画
四、滑动接口OnPageChangeListener说明
ViewPager的关键在于页面滑动,现对滑动事件的接口OnPageChangeListener()进行详细介绍与分析
4.1 滑动接口介绍
- Viewpage的滑动接口:OnPageChangeListener()
- 在OnPageChangeListener接口里,必须复写的三个方法:
- onPageScrollStateChanged(int arg0)
- onPageScrolled (int arg0,float arg1,int arg2)
- onPageSelected(int arg0)
4.2 复写方法介绍
4.2.1 onPageScrollStateChanged(int arg0)
- 方法调用:页面状态改变时
- 页面状态分为静止、滑动时和滑动后
- 参数说明:arg0=页面状态,页面状态分别是:
- SCROLL_STATE_IDLE:空闲状态
- SCROLL_STATE_DRAGGING:滑动状态
- SCROLL_STATE_SETTLING:滑动后自然沉降的状态
4.2.2 onPageScrolled(int arg0,float arg1,int arg2)
- 方法调用:当页面在滑动时至滑动被停止之前,此方法会一直调用
- 参数说明:
- arg0 :当前页面,及你点击滑动的页面
- arg1:当前页面偏移的百分比
- arg2:当前页面偏移的像素位置
4.2.3 onPageSelected(int arg0)
- 方法调用:页面跳转完后调用
- 参数说明:arg0=当前选中页面的Position(位置编号)
4.3 具体调用顺序(附实例)
用“滑动一次页面:从欢迎页1滑动到欢迎页2”的实例来说明上述复写方法的调用顺序。
//设置viewPager页面滑动的事件
viewpager.setOnPageChangeListener(new ViewPager.OnPageChangeListener() {
//页面状态改变时调用
@Override
public void onPageScrollStateChanged(int arg0) {
switch (arg0) {
case ViewPager.SCROLL_STATE_IDLE:
System.out.println("onPageScrollStateChanged==SCROLL_STATE_IDLE==空闲状态");
break;
case ViewPager.SCROLL_STATE_DRAGGING:
System.out.println("onPageScrollStateChanged==SCROLL_STATE_DRAGGING==正在滑动");
break;
case ViewPager.SCROLL_STATE_SETTLING:
System.out.println("onPageScrollStateChanged==SCROLL_STATE_SETTLING==自然沉降");
break;
}
}
//页面滑动过程中调用
@Override
public void onPageScrolled(int arg0, float arg1, int arg2) {
System.out.println("onPageScrolled==滑动中==滑动前页面位置是:”+arg0);
}
//页面滑动后调用
@Override
public void onPageSelected(int arg0) {
System.out.println("onPageSelected==滑动后==页面停留位置是:"+arg0);
}
});
onPageScrollStateChanged==SCROLL_STATE_DRAGGING==正在滑动
onPageScrolled==滑动中==滑动前页面位置是:0
onPageScrolled==滑动中==滑动前页面位置是:0
onPageScrollStateChanged==SCROLL_STATE_SETTLING==自然沉降
onPageSelected==滑动后==页面停留位置是:1
onPageScrolled==滑动中==滑动前页面位置是:0
onPageScrolled==滑动中==滑动前页面位置是:0
onPageScrolled==滑动中==滑动前页面位置是:0
onPageScrolled==滑动中==滑动前页面位置是:0
onPageScrolled==滑动中==滑动前页面位置是:0
onPageScrolled==滑动中==滑动前页面位置是:0
onPageScrolled==滑动中==滑动前页面位置是:1
onPageScrollStateChanged==SCROLL_STATE_IDLE==空闲状态
五、其他
5.1 FragmentPagerAdapter数据刷新notifyDataSetChanged没效果
- (4.3.1.13)Android FragmentPagerAdapter数据刷新notifyDataSetChanged没效果研究
- (4.3.1.13.1) FragmentPagerAdapter刷新fragment最完美解决方案
5.2 Fragment中使用ViewPage
- (4.3.1.12)Fragment中使用ViewPager时,ViewPager里的Fragment错位和空白问题。
- (4.3.1.6)【项目一】子Fragment之ViewPager和FragmentPagerAdapter
5.3 不保留活动下,fragments自动重建
5.4 缓存机制
PagerAdapter作为ViewPager的适配器,无论ViewPager有多少页,PagerAdapter在初始化时也只初始化开始的2个View,即调用2次instantiateItem方法。
而接下来每当ViewPager滑动时,PagerAdapter都会调用destroyItem方法将距离该页2个步幅以上的那个View销毁,以此保证PagerAdapter最多只管辖3个View,且当前View是3个中的中间一个,如果当前View缺少两边的View,那么就instantiateItem,如里有超过2个步幅的就destroyItem
| 0 | 1 | 2 | 3 | 4
- pageradapter初始化的时候会加载0和1(这里说的加载就是调用instantiateitem方法)
- 向右滑动就会加载2
- 然后向右滑动就加载3,同时把0销毁(这里说的销毁就是调用destroyItem方法),以此类推
这里就是viewpager的缓存情况,默认就是缓存当前view的左右两个,过这个值可以设置
public void setOffscreenPageLimit(int limit) {
if (limit < DEFAULT_OFFSCREEN_PAGES) {
Log.w(TAG, "Requested offscreen page limit " + limit + " too small; defaulting to " +
DEFAULT_OFFSCREEN_PAGES);
limit = DEFAULT_OFFSCREEN_PAGES;
}
if (limit != mOffscreenPageLimit) {
mOffscreenPageLimit = limit;
populate();
}
}