TabPager

TabPager不仅集成了TabLayout和ViewPager，还封装了根据具体页面根据不同的加载状态而显示不同页面的功能，也可以自定义这些页面和其他一些属性。如果某个页面加载数据不成功，切换到其他页面再回来时，框架会自动调用重试加载功能；如果加载成功了，则不再重试加载。除此之外，还提供了一些实用的对外接口。

1. 运行效果

屏幕截图：

ScreenShot

Demo下载体验，TabPager ，或者扫描二维码下载

2. 简单用法

第一步，添加依赖

dependencies {
compile 'com.yhy:tpg:latestVersion'
}

第二步，再布局文件中使用控件

<com.yhy.tpg.widget.TpgView
  android:id="@+id/tv_content"
  android:layout_width="match_parent"
  android:layout_height="match_parent" />

第三步，给TpgView设置适配器（“页面参数”在扩展中介绍）

MainActivity中（必须是FragmentActivity的子类，才能获取到FragmentManager实例）

private static final String[] TABS = {"菜单A", "菜单B", "菜单C", "菜单D", "菜单E", "菜单F", "菜单G", "菜单H"};

//获取到布局中的控件
tvContent = (TpgView) findViewById(R.id.tv_content);

//设置适配器
mAdapter = new PagersAdapter(getSupportFragmentManager());
tvContent.setAdapter(mAdapter);

//内部类中定义适配器
private class PagersAdapter extends TpgAdapter {

//没有页面配置参数时使用该构造函数
public PagersAdapter(FragmentManager fm) {
  super(fm);
}

//使用页面配置参数时使用该构造函数
public PagersAdapter(FragmentManager fm, PagerConfig config) {
  super(fm, config);
}

@Override
public CharSequence getPageTitle(int position) {
  return TABS[position];
}

@Override
public int getCount() {
  return TABS.length;
}

@Override
public TpgFragment getPager(int position) {
  return PagerFactory.create(position);
}
}

PagerFactory中

public static TpgFragment create(int position) {
      TpgFragment pager = null;

      switch (position) {
          case 0:
              pager = new APager();
              break;
          case 1:
              pager = new BPager();
              break;
          case 2:
              pager = new CPager();
              break;
          case 3:
              pager = new DPager();
              break;
          case 4:
              pager = new EPager();
              break;
          case 5:
              pager = new FPager();
              break;
          case 6:
              pager = new GPager();
              break;
          case 7:
              pager = new HPager();
              break;
          default:
              break;
      }

      return pager;
  }

第四步，在具体页面类必须继承自TpgFragment，实现抽象方法getSuccessView()，并返回加载成功时的页面（以APager为例）

public class APager extends TpgFragment {
...

@Override
protected View getSuccessView() {
  TextView tv = new TextView(getContext());
  tv.setText("A页面加载成功");
  tv.setTextColor(Color.RED);
  tv.setTextSize(32);
  tv.setGravity(Gravity.CENTER);
  //返回加载成功时的页面
  return tv;
}

...
}

第五步，实现抽象方法initData(ResultHandler handler)，将数据请求部分的操作放在该方法中，便于TpgView获取到数据加载结果状态。但是加载结果还需要参数handler来操作…

@Override
protected void initData(ResultHandler handler) {
mResultHandler = handler;

//请求服务器数据
getDataFromServer();
}

//模拟请求服务器数据过程
private void getDataFromServer() {
//用来产生一个随机的状态
final Random random = new Random();
new Thread() {
  @Override
  public void run() {
    //模拟网络加载延迟
    SystemClock.sleep(3000);

    //数据加载结束后，需要手动刷新页面状态
    int temp = random.nextInt(3);
    switch (temp) {
      case 0:
        //如果加载成功，就发送成功的Handler
        mResultHandler.sendSuccessHandler();
        break;
      case 1:
        //加载失败，发送错误Handler
        mResultHandler.sendErrorHandler();
        break;
      case 2:
        //数据为空，发送空数据Handler
        mResultHandler.sendEmptyHandler();
        break;
      default:
        break;
    }
  }
}.start();
}

以上就是简单用法的详细步骤。

3. 扩展

自定义属性

在布局文件中自行定义

属性名	属性说明	默认值
tab_height	Tab栏高度	48dp
tab_bg_color	Tab栏的背景颜色	透明
tab_text_normal_color	普通状态下选项卡字体颜色	aaff4400
tab_text_selected_color	选中状态下选项卡字体颜色	ffff2200
tab_indicator_color	选项指示条的颜色	ffff2200
tab_indicator_height	选项指示条的高度	3dp
tab_mode	TabLayout的TabMode	MODE_SCROLLABLE
tab_gravity	TabLayout的TabGravity	GRAVITY_FILL
expand_visible	是否显示可扩展图标	VISIBLE
expand_icon	可扩展图标资源	——

如果第一页数据未自动加载

由于数据加载方法时在ViewPager页面切换后才被回调的，而控件第一次加载时不会触发页面切换，所以只能手动加载第一页数据。通过封装后，只需要重写父类的shouldLoadDataAtFirst()方法，并返回true即可自动加载该页数据。
```
@Override
public boolean shouldLoadDataAtFirst() {
  return true;
}
```

页面配置参数（上文提到过）

框架已提供默认的加载中页面、错误页面和空数据页面，但是可能这些都不太适合你，你可以通过该参数配置自己想要的这些页面。该参数只在当前TpgView中有效。

注意：该参数必须在设置适配器前配置，通过适配器构造方法设置。

//页面配置，只在当前TpgView有效
private PagerConfig mConfig;

//配置页面参数
mConfig = new PagerConfig(this);
//设置空页面的资源id
mConfig.setEmptyViewResId(R.layout.layout_view_empty);

//设置适配器，传入页面配置参数
mAdapter = new PagersAdapter(getSupportFragmentManager(), mConfig);
tvContent.setAdapter(mAdapter);

单独页面的页面

不仅可以配置TpgView范围的页面配置，也可以单独为某一个页面配置相关页面，只需要重写父类的相应方法，并返回页面即可。以配置某个页面的加载中页面为例。
```
@Override
protected View getLoadingView() {
//只属于B页面的加载中页面
return View.inflate(getContext(), R.layout.layout_view_loading_b, null);
}
```
重试加载

框架提供的默认页面已经处理了重试加载功能，但是如果你是自定义的页面（通过以上两种方法），可能你也需要重试加载数据功能，比如“点击按钮重试”之类的功能。只需要在具体需要重试加载的地方调用方法shouldLoadData()即可。
```
retryBtn.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
  //重试加载数据
  shouldLoadData();
}
});
```

对外事件接口

已将ViewPager的页面滑动事件和右上角扩展按钮的点击事件提供对外接口

//扩展按钮点击事件
tvContent.setOnExpandListener(new TpgView.OnExpandListener() {
@Override
public void onExpand(View view) {
}
});

//页面滑动事件
tvContent.setOnPageChangedListener(new TpgView.OnPageChangedListener() {
@Override
public void onPageScrolled(int position, float positionOffset, int
                           positionOffsetPixels) {
}

@Override
public void onPageSelected(int position) {
}

@Override
public void onPageScrollStateChanged(int state) {
}
});

重新加载某页数据

也许这个功能是没用的为什么这么说呢？如果在某个页面中，你需要重新加载数据，可以直接调用你加载数据的方法即可，比如getDataFromServer()方法，根本不需要框架提供的重新加载数据方法。不过，如果想要在这些页面之外重新加载某个页面的数据的话（比如点击了右上角扩的展按钮之后，一般是要选一些查询条件，然后在重新查询当前页面的数据），就不太好办了因为你需要调用到具体页面的getDataFromServer()方法，而你能想到的方法应该是把所有页面缓存到一个集合中，需要重新加载某页数据时，再取出相应页面，然后调用重新加载方法。当然，这也不失为一种好方法，不过，个人觉得框架中也应该提供默认的重新加载数据的方法，于是才有了该功能。

如何实现呢？？

只需要在具体页面中重写reloadDate(Object... args)方法，实现重新加载数据的逻辑，然后在需要出发重新加载操作的地方调用以下方法即可。

重新加载某个页面的数据：reloadDataForPager(int index, Object... args)

参数：index 当前页面索引

args 重新加载时，可能需要的参数

重新加载当前页面数据：reloadDataForCurrentPager(Object... args)

参数： args 重新加载时，可能需要的参数
```
//重写父类方法
@Override
public void reloadDate(Object... args) {
//接收参数
String temp = "";
if (null != args && args.length > 0 && args[0] instanceof String) {
  temp = (String) args[0];
}
ToastUtils.shortToast(temp + "页面重新加载数据");

//请求数据
getDataFromServer();
}

//在外部通过适配器调用重新加载数据方法
if (null != mAdapter) {
//通过适配器重新加载当前页面的数据
mAdapter.reloadDataForCurrentPager(TABS[tvContent.getCurrentPager()]);
}
```

Github：TabPager

就这些啦，哈哈，大家如果有什么意见或好建议，欢迎发表！！