咱们在开发过程中经常需要从网络上获取数据。这个时候为了增强用户体验。就可能有如下需求:在获取的数据的中时候显示加载中的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 实体视图*/@NonNullView getView();/*** 设置提示信息*/void setPromptMessage(String msg);/*** 设置重试监听*/void setOnRetryListener(OnRetryListener listener);/*** View是否显示(有的时候可能会启动一些动画,可以在这里做开始停止的动作)*/void visible(boolean visible);}
三、如何使用
状态呢,咱么是有四种.CONTENTstate对应的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下载链接.