首先,学习的是git上人家提供的依赖,参考https://github.com/weavey/LoadingLayoutDemo,
本文只是对于这个依赖简单介绍使用,相对来说更加适合直接上手的码友们
- 介绍
其实,简单来讲,就是Loadinglayout封装了加载出错界面、无数据界面、
无网络界面、加载中界面(可以自定义),在使用的时候,只需根据你程序中
的具体情况,选择合适的界面展示便可以,使用起来,较为灵活。
- 导入依赖到你的工程
compile 'com.lai.weavey:loadinglayout:1.3.1'
- 使用
1 在全局中配置如下信息,配置界面
包含有上述四个界面,在这里可以进行初始化配置:
建议在全局中配置四个界面的基础信息,最好在自己写的application中完成
LoadingLayout.getConfig()
.setErrorText("出错啦~请稍后重试!")//设置加载出错界面上的提示文字,可修改
.setErrorImage(R.mipmap.define_error)//设置加载出错界面上的提示图片,可修改
.setEmptyText("抱歉,暂无数据")//设置无数据展示界面上的提示文字,可根据需求修改
.setEmptyImage(R.mipmap.define_empty)//在无数据展示界面上的提示图片,可根据需求修改
.setNoNetworkText("无网络连接,你个什么网络···")//在没有网络连接界面上的提示文字,可修改
.setNoNetworkImage(R.mipmap.define_nonetwork)//在没有网路连接界面上的提示图片。可修改
.setAllTipTextColor(R.color.gray)//设置所有提示文本的字体颜色
.setAllTipTextSize(14)//设置所有提示文本的字体大小
.setAllPageBackgroundColor(R.color.background)//设置所有界面背景颜色
.setReloadButtonText("点我重试哦")//设置每一个界面上重新加载那个按钮的文本
.setReloadButtonTextSize(14)//设置每个界面上重新加载那个按钮的文本大小
.setReloadButtonTextColor(R.color.gray)//设置每个界面上重新加载那个按钮的字体颜色
.setReloadButtonWidthAndHeight(150,40)//设置每个界面上重新加载那个按钮的宽和高
LoadingLayout对象可以:
.setLoadingPageLayout(R.layout.define_loading_page);//设置页面是自己的界面。这个界面只是针对的加载中界面,使用自定义的界面
2 控制合适的界面
LoadingLayout其实可以认为是定义了四个界面,分别为加载中、无网络、无数据、出错四种情况
在使用过程中,只需要根据你自己的需求选择合适的界面进行展示就可以(但是对应五种选择)
此处需要的是LoadingLayout的对象,下面的代码表示调用不同的界面
loadingLayout.setStatus(LoadingLayout.Loading);//表示展示加载界面
loadingLayout.setStatus(LoadingLayout.Empty);//表示展示无数据界面
loadingLayout.setStatus(LoadingLayout.Error);//表示展示加载错误界面
loadingLayout.setStatus(LoadingLayout.No_Network);表示无网络连接界面
loadingLayout.setStatus(LoadingLayout.Success);表示加载成功,
会使得loadingLayout界面消失
展示正常应用应该展示的界面
3还有一个监听,针对loadingLaout对象
通过给当前的LoadingLayout对象设置
loadingLayout.setOnReloadListener(new LoadingLayout.OnReloadListener() {
@Override
public void onReload(View v) {
loadingLayout.setStatus(LoadingLayout.Success);
}});
//一般针对无网络什么的上面的那个重新加载那个功能的监听,在onReload中完成后续操作,比如用户看到
没有网络链接了,可以选择加载什么的就会有数据了。
4一个界面要想使用LoadgingLayout要在布局中如下所示
参照图片,有如下注意的地方
(1) 由于LoadingLayout原理是在xml渲染完成后在contentView上铺上三层View(contentview表示内容页面)
isFirstVisible属性用来控制contentView一开始是否隐藏,一开始如果不隐藏,等contentView渲染完成后调用:loadingLayout.setStatus(LoadingLayout.Loading);
会造成界面闪烁的效果,影响体验,因此默认将contentView隐藏,所以数据加载完成后一定要调用loadingLayout.setStatus(LoadingLayout.Success);
,将contentView显示出来。
(2)为了方便管理,LoadingLayout只能有一个直属子View,类似ScrollView,添加两个直属子View会抛出异常throw new IllegalStateException("LoadingLayout can host only one direct child");
(3)由于AS会直接将自定义View的特性反应在预览界面,所以在使用LoadingLayout的时候,会无法看到被LoadingLayout包裹住的布局(默认为gone),因此也可以将isFirstVisible属性暂时设为true,预览布局。
如果不加入isFirstVisible的话,那么在预览时候上面什么也没有。
(4)要把LoadingLayout放在所需要的布局文件的根标签中。