StateController顾名思义：状态控制机，用作几个状态的切换。该控件可以在Loading & Empty & Error& Content四个状态的自定义动画切换。
特性
- 不受布局层级的控制，可任意大小、任意层级
- 支持xml设置状态布局资源
- 支持java代码设置状态布局
- 可自定义动画切换状态
- 可注册状态切换回调
- 支持异常情况的状态保存
- 可以设置一个或几个状态，无需全部状态设置
集成步骤
step1
在根项目的build.gradle文件中添加
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}step2
添加依赖
dependencies {
compile 'compile 'com.github.limedroid:XStateController:v1.1.0'
}
使用
<cn.droidlover.xstatecontroller.XStateController
android:id="@+id/controller"
android:layout_width="match_parent"
android:layout_height="match_parent"
app:x_emptyLayoutId="@layout/view_empty">
<TextView
android:layout_width="match_parent"
android:layout_height="match_parent"
android:background="#854678"
android:gravity="center"
android:text="Content"
android:textColor="@android:color/white"
android:textSize="28sp" />
</cn.droidlover.xstatecontroller.XStateController>说明
- 当
XStateController仅有一个子view（ViewGroup）时，该子view则为ContentView - 可以通过xml属性设置布局，也可代码设置
attrs设置状态布局资源
<attr name="x_contentLayoutId" format="reference" />
<attr name="x_loadingLayoutId" format="reference" />
<attr name="x_emptyLayoutId" format="reference" />
<attr name="x_errorLayoutId" format="reference" />x_contentLayoutId设置内容布局资源x_loadingLayoutId设置加载中状态的布局资源x_emptyLayoutId设置空状态的布局资源x_errorLayoutId设置错误状态的布局资源
常见api
设置各状态的布局资源
loadingView(loadingView)； //设置加载中的view
emptyView(emptyView)； //设置空view
errorView(errorView)； //设置errorView
contentView(contentView); //设置contentView状态切换
showLoading(); //切换到loading状态
showError(); //切换到error状态
showEmpty(); //切换到empty状态
showContent(); //切换到content状态注册状态切换回调
registerStateChangeListener(xx);回调的定义
public interface OnStateChangeListener {
//状态切换时回调，oldState当前状态,newState目标状态
void onStateChange(int oldState, int newState);
//动画，可自定义切换动画
void animationState(View exitView, View enterView);
}使用时可直接继承SimpleStateChangeListener
