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中使用到了DataBinding，DataBinding的使用可以通过我的另一篇文章来了解。

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