ViewPager使用详解(一):PagerAdapter


ViewPager是Google的support.v4包中的支持控件,可以实现View之间的切换。

ViewPager的使用在目前的应用环境中非常频繁,甚至对其进行相关的自定义来实现一些特别的效果。

ViewPager使用详解系列只是对于Google官方提供的支持库中的相关工具来实现效果,不涉及到自定义的东西。

ViewPager最简单的使用方法,就是与PagerAdapter的配合使用,所以我们必须了解PagerAdapter中的方法及其对应的功能。

public class ViewPagerAdapter extends PagerAdapter {
    /**
     * 获取View的总数
     *
     * @return View总数
     */
   @Override
   public int getCount() {
       return 0;
   }

   /**
    * 当ViewPager的内容有所变化时,进行调用。
    *
    * @param container ViewPager本身
    */
   @Override
   public void startUpdate(ViewGroup container) {
       super.startUpdate(container);
   }
   
   /**
    * 为给定的位置创建相应的View。创建View之后,需要在该方法中自行添加到container中。
    *
    * @param container ViewPager本身
    * @param position  给定的位置
    * @return 提交给ViewPager进行保存的实例对象
    */
   @Override
   public Object instantiateItem(ViewGroup container, int position) {
       return super.instantiateItem(container, position);
   }
   
   /**
    * 为给定的位置移除相应的View。
    *
    * @param container ViewPager本身
    * @param position  给定的位置
    * @param object    在instantiateItem中提交给ViewPager进行保存的实例对象
    */
   @Override
   public void destroyItem(ViewGroup container, int position, Object object) {
       super.destroyItem(container, position, object);
   }
   
   /**
    * ViewPager调用该方法来通知PageAdapter当前ViewPager显示的主要项,提供给用户对主要项进行操作的方法。
    *
    * @param container ViewPager本身
    * @param position  给定的位置
    * @param object    在instantiateItem中提交给ViewPager进行保存的实例对象
    */
   @Override
   public void setPrimaryItem(ViewGroup container, int position, Object object) {
       super.setPrimaryItem(container, position, object);
   }
   
   /**
    * 当ViewPager的内容变化结束时,进行调用。当该方法被调用时,必须确定所有的操作已经结束。
    *
    * @param container ViewPager本身
    */
   @Override
   public void finishUpdate(ViewGroup container) {
       super.finishUpdate(container);
   }
   
   /**
    * 确认View与实例对象是否相互对应。ViewPager内部用于获取View对应的ItemInfo。
    *
    * @param view   ViewPager显示的View内容
    * @param object 在instantiateItem中提交给ViewPager进行保存的实例对象
    * @return 是否相互对应
    */
   @Override
   public boolean isViewFromObject(View view, Object object) {
       return false;
   }
   
   /**
    * 保存与PagerAdapter关联的任何实例状态。
    *
    * @return PagerAdapter保存状态
    */
   @Override
   public Parcelable saveState() {
       return super.saveState();
   }
   
   /**
    * 恢复与PagerAdapter关联的任何实例状态。
    *
    * @param state  PagerAdapter保存状态
    * @param loader 用于实例化还原对象的类加载器
    */
   @Override
   public void restoreState(Parcelable state, ClassLoader loader) {
       super.restoreState(state, loader);
   }
   
   /**
    * 当ViewPager试图确定某个项的位置是否已更改时调用。默认有两个可选项:POSITION_UNCHANGED和POSITION_NONE。
    * POSITION_UNCHANGED:给定项的位置未变更
    * POSITION_NONE:给定项不再用于PagerAdapter中
    * 其他值:可以根据具体的情况进行调整
    *
    * @param object 在instantiateItem中提交给ViewPager进行保存的实例对象
    * @return
    */
   @Override
   public int getItemPosition(Object object) {
       return super.getItemPosition(object);
   }
   
   /**
    * 新增方法,目前较多用于Design库中的TabLayout与ViewPager进行绑定时,提供显示的标题。
    *
    * @param position 给定的位置
    * @return 显示的标题
    */
   @Override
   public CharSequence getPageTitle(int position) {
       return super.getPageTitle(position);
   }
   
   /**
    * 获取给定位置的View的显示宽度比例,该比例是相对于ViewPager。
    *
    * @param position 给定的位置
    * @return View显示的宽度比例
    */
   @Override
   public float getPageWidth(int position) {
       return super.getPageWidth(position);
   }

 }

当然,这么多的方法,其实我们经常使用到的只是其中的一部分而已,最简单的SimplePagerAdapter

public class SimplePagerAdapter extends PagerAdapter {
   private LayoutInflater mInflater;
   
   public SimplePagerAdapter(Context context) {
       mInflater = LayoutInflater.from(context);
   }
   
   @Override
   public int getCount() {
       return 5;
   }
   
   @Override
   public Object instantiateItem(ViewGroup container, int position) {
       return DataBindingUtil.inflate(mInflater, R.layout.item_simple_pager, container, true);
   }
   
   @Override
   public void destroyItem(ViewGroup container, int position, Object object) {
       ItemSimplePagerBinding dataBinding = (ItemSimplePagerBinding) object;
       container.removeView(dataBinding.getRoot());
   }
   
   @Override
   public void setPrimaryItem(ViewGroup container, int position, Object object) {
       ItemSimplePagerBinding dataBinding = (ItemSimplePagerBinding) object;
       dataBinding.tvContent.setText(getPageTitle(position));
   }
   
   @Override
   public boolean isViewFromObject(View view, Object object) {
       ItemSimplePagerBinding dataBinding = (ItemSimplePagerBinding) object;
       return dataBinding.getRoot() == view;
   }
   
   @Override
   public CharSequence getPageTitle(int position) {
       return String.valueOf(position + 1);
   }}

SimplePagerAdapter中使用到了DataBindingDataBinding的使用可以通过我的另一篇文章来了解。

网络上的其他关于PagerAdapter的使用,有很多人直接在instantiateItem中进行View的数据更新,这种方式也是可行,但建议将View的创建与数据的更新区分开,这样结构清晰,而且便于数据的操作。



作者:枯葉殘秋
链接:https://www.jianshu.com/p/6fabf634d5bd
来源:简书
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。


©小网格工作室 2013-2025