Awesome

#XStateController 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