安卓控件Android知识Android开发

LoadingLayout的学习

2016-12-12  本文已影响178人  难得糊涂与君勉

首先,学习的是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要在布局中如下所示

Paste_Image.png

参照图片,有如下注意的地方
(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放在所需要的布局文件的根标签中。

上一篇 下一篇

猜你喜欢

热点阅读