咱们在开发过程中经常需要从网络上获取数据。这个时候为了增强用户体验。就可能有如下需求:在获取的数据的中时候显示加载中的UI(获取数据需要 一定的时间)、如果获取数据失败显示失败的UI、获取的数据为空的时候显示空数据的UI、数据成功获取到的时候才显示获取到的数据列表。总之一句话就是根据不同的状态现实不同的UI。这也是我们这篇文章的重点.接下来咱么就对这一需求做一个简单的封装。
一、效果图
在代码之前先把效果图贴出来给大伙看下.
-
默认的数据为空,数据加载失败,数据加载中UI.
-
自定义各个状态的UI样式(这里用了YY-SVGA动画框架 官网)
加入了下拉刷新功能
-
同一个界面有多个地方使用
二、实现过程
状态不同显示的UI不同.所以我们先确定下我们要支持的状态有哪些,如下:
public enum State {
/**
* 数据内容显示
*/
CONTENT,
/**
* 数据加载中
*/
ING,
/**
* 数据为空
*/
EMPTY,
/**
* 数据加载失败
*/
ERROR
}
然后就是对布局进行封装了,StateLayout就是用来管理这四个状态的UI切换的.StateLayout里面肯定会有对应上面四种状态的View实例:数据获取成功对应view实例、数据为空对应view实例、数据获取失败对应view实例子、数据获取中对应view实例.StateLayout要做的事情就是根据不同的状态确定哪些view显示,哪些view不显示.这也是StateLayout里面最核心的逻辑了.代码如下:
public void switchState(State state) {
if (mState != null && mState == state) {
return;
}
switch (state) {
case CONTENT:
mContentView.setVisibility(VISIBLE);
mStateIngView.getView().setVisibility(GONE);
mStateIngView.visible(false);
mStateEmptyView.getView().setVisibility(GONE);
mStateEmptyView.visible(false);
mStateErrorView.getView().setVisibility(GONE);
mStateErrorView.visible(false);
break;
case ING:
mContentView.setVisibility(GONE);
mStateIngView.getView().setVisibility(VISIBLE);
mStateIngView.visible(true);
mStateEmptyView.getView().setVisibility(GONE);
mStateEmptyView.visible(false);
mStateErrorView.getView().setVisibility(GONE);
mStateErrorView.visible(false);
break;
case EMPTY:
mContentView.setVisibility(GONE);
mStateIngView.getView().setVisibility(GONE);
mStateIngView.visible(false);
mStateEmptyView.getView().setVisibility(VISIBLE);
mStateEmptyView.visible(true);
mStateErrorView.getView().setVisibility(GONE);
mStateErrorView.visible(false);
break;
case ERROR:
mContentView.setVisibility(GONE);
mStateIngView.getView().setVisibility(GONE);
mStateIngView.visible(false);
mStateEmptyView.getView().setVisibility(GONE);
mStateEmptyView.visible(false);
mStateErrorView.getView().setVisibility(VISIBLE);
mStateErrorView.visible(true);
break;
}
mState = state;
}
考虑到每种状态都可能有一些额外的需求.比如加载失败的状态可能额外需要有一个重新加载的按钮,或者自定义显示加载失败的文字.所以为了能尽量更多的去适应这样的功能需求,这里每种状态的view其实我都有写一个接口,让去各自实现.比如加载失败状态的接口:
public interface StateErrorInterface {
interface OnRetryListener {
void onRetry();
}
/**
* 获取实体视图
*
* @return 实体视图
*/
@NonNull
View getView();
/**
* 设置提示信息
*/
void setPromptMessage(String msg);
/**
* 设置重试监听
*/
void setOnRetryListener(OnRetryListener listener);
/**
* View是否显示(有的时候可能会启动一些动画,可以在这里做开始停止的动作)
*/
void visible(boolean visible);
}
三、如何使用
状态呢,咱么是有四种.CONTENT state对应的UI是要打交道最多的,这个状态的UI咱们不做过多的控制.按照常规findViewById()找到这个状态里面的View然后使用.咱们主要是对其他三种状态做了一个简单的封装,既可以使用里面默认的状态UI也可以自定义的状态对应UI.就是要注意自定义状态UI的时候一定要实现对应的接口方法:自定义数据为空的时候的UI要实现StateEmptyInterface接口、自定义数据加载失败的时候的UI要实现StateErrorInterface接口、要实现数据加载中的时候的UI的时候要实现StateIngInterface接口.
默认的状态UI也是支持修改功能的
/**
* 设置默认的加载中的UI
*
* @param creator IngCreator
*/
public static void setDefaultIngCreator(IngCreator creator) {
sIngCreator = creator;
}
/**
* 设置默认数据为空的时候的UI
*
* @param creator EmptyCreator
*/
public static void setDefaultEmptyCreator(EmptyCreator creator) {
sEmptyCreator = creator;
}
/**
* 设置默认数据获取失败时候的UI
*
* @param creator ErrorCreator
*/
public static void setDefaultErrorCreator(ErrorCreator creator) {
sErrorCreator = creator;
}
关于Android状态切换Layout(数据加载中,数据加载失败,空数据)的东西就说这么多,里面更加具体的细节和使用方式可以参考DEMO下载链接.