LoadDataLayout

Introduction: App 公共组件:加载数据 Layout,高效开发必备!
More: Author   ReportBugs   
Tags:
加载数据-Layout-

App 公共组件:加载数据 Layout,高效开发必备!

项目中经常会遇到几种页面:加载中、无网络、无数据、出错四种情况,传统的方式是通过 include 相关的布局,逐个分情况设置显示或隐藏,这样繁琐的过程一直是个痛点,于是参考了 Weavey 的封装套路,自己重新写了一套,进行了一些优化和扩展,虽然说原理不会太复杂(继承 FrameLayout,XML 渲染完成后,加上四个页面,然后按需控制显示哪一层),但若把它分离出来确实是提升开发效率的一个利器。

Demo

运行效果图:

LoadDataLayout

Usage

  • step 1:

在你项目的 build.gradle 文件中添加依赖

compile 'com.ganxin.library:loaddatalayout:1.0.1'

  • step 2:

在需要用到的布局中引入相关的 Layout:

普通样式:LoadDataLayout


<com.ganxin.library.LoadDataLayout
    android:id="@+id/loadDataLayout"
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <TextView
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:background="@color/blue"
        android:gravity="center"
        android:text="contentView"
        android:textColor="@color/white"
        android:textSize="20sp"/>

</com.ganxin.library.LoadDataLayout>

仿知乎样式:SwipeLoadDataLayout


<com.ganxin.library.SwipeLoadDataLayout
    android:id="@+id/swipeLoadDataLayout"
    style="@style/common_swipeLoadDataLayout"
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <TextView
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:background="@color/blue"
        android:gravity="center"
        android:text="contentView"
        android:textColor="@color/white"
        android:textSize="20sp"/>

</com.ganxin.library.SwipeLoadDataLayout>

支持的自定义属性:

loadingText:加载页面显示的文本,可选,仅 LoadDataLayout 可用

loadingTextSize:加载页面显示的图片,可选,仅 LoadDataLayout 可用

loadingTextColor:加载页面文本的颜色,可选,仅 LoadDataLayout 可用

loadingViewLayoutId:自定义加载页面的布局 Id,可选,仅 LoadDataLayout 可用,如果设置了该属性,上面的三个属性失效

emptyText:无数据页面显示的文本,可选

emptyImgId:无数据页面显示的图片,可选

emptyImageVisible:无数据页面图片的可见性,可选,默认为 true

errorText:出错页面显示的文本,可选

errorImgId:出错页面显示的图片,可选

errorImageVisible:出错页面图片的可见性,可选,默认为 true

noNetWorkText:无网络页面显示的文本,可选

noNetWorkImgId:无网络页面显示的图片,可选

noNetWorkImageVisible:无网络页面图片的可见性,可选,默认为 true

allTipTextColor:无数据、无网络、出错三个页面的文本颜色,可选

allTipTextSize:无数据、无网络、出错三个页面的文本字体大小,可选

allPageBackgroundColor:四个页面的背景色,可选

reloadBtnText:重新加载按钮的文本,可选

reloadBtnTextSize:重新加载按钮的文本字体大小,可选

reloadBtnTextColor:重新加载按钮的文本颜色,可选

reloadBtnBackgroundResource:重新加载按钮的背景资源,可选

reloadBtnVisible:重新加载按钮的可见性,可选,默认为 true

reloadClickArea:重新加载按钮的点击区域,full 代表整个页面,button 代表仅 button 大小区域,默认 button

除了在 XML 设置属性外,支持全局配置,对所有使用的地方起作用,需要在 Application 中配置,示例:


public class App extends Application {

    @Override
    public void onCreate() {
        super.onCreate();

        LoadDataLayout.getBuilder()
                .setLoadingText(getString(R.string.custom_loading_text))
                .setLoadingTextSize(16)
                .setLoadingTextColor(R.color.colorPrimary)
                //.setLoadingViewLayoutId(R.layout.custom_loading_view) //如果设置了自定义 loading 视图,上面三个方法失效
                .setEmptyImgId(R.drawable.ic_empty)
                .setErrorImgId(R.drawable.ic_error)
                .setNoNetWorkImgId(R.drawable.ic_no_network)
                .setEmptyImageVisible(true)
                .setErrorImageVisible(true)
                .setNoNetWorkImageVisible(true)
                .setEmptyText(getString(R.string.custom_empty_text))
                .setErrorText(getString(R.string.custom_error_text))
                .setNoNetWorkText(getString(R.string.custom_nonetwork_text))
                .setAllTipTextSize(16)
                .setAllTipTextColor(R.color.text_color_child)
                .setAllPageBackgroundColor(R.color.pageBackground)
                .setReloadBtnText(getString(R.string.custom_reloadBtn_text))
                .setReloadBtnTextSize(16)
                .setReloadBtnTextColor(R.color.colorPrimary)
                .setReloadBtnBackgroundResource(R.drawable.selector_btn_normal)
                .setReloadBtnVisible(true)
                .setReloadClickArea(LoadDataLayout.FULL);
    }
}

为了适应某个界面的“特殊需求”,也支持局部设置各种属性,仅对当前对象生效,不影响全局,示例:


        loadDataLayout.setEmptyText("暂无数据显示")
                .setErrorText("出错啦")
                .setErrorImage(R.drawable.ic_error)
                .setAllTipTextSize(20)
                .setReloadBtnText("点我重新加载")
                .setReloadClickArea(LoadDataLayout.FULL);
                //and so on...
  • step 3:

为 ReloadButton 设置监听:


       loadDataLayout.setOnReloadListener(new LoadDataLayout.OnReloadListener() {
            @Override
            public void onReload(View v, int status) {

            }
        });

根据实际需要,设置显示的页面:


        loadDataLayout.setStatus(LoadDataLayout.LOADING); //加载中
        loadDataLayout.setStatus(LoadDataLayout.EMPTY); //无数据
        loadDataLayout.setStatus(LoadDataLayout.ERROR); //出错
        loadDataLayout.setStatus(LoadDataLayout.NO_NETWORK); //无网络
        loadDataLayout.setStatus(LoadDataLayout.SUCCESS); //加载成功

Remarks

  • LoadDataLayout 默认一开始是隐藏 contengView 的,而 SwipeLoadDataLayout 中设置 status 为 Loading 时,contentView 是显示的。
  • LoadDataLayout 和 SwipeLoadDataLayout 只能有一个直属子 View,类似 ScrollView,添加两个直属子 View 会抛异常:throw new IllegalStateException

Reference

《直接拿去用!每个 App 都会用到的 LoadingLayout》

Contact Me

  • QQ:445253393(注明来自 GitHub)
  • Email:mail@wangganxin.me

License

MIT License

Copyright (c) 2017 守望君

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
Apps
About Me
GitHub: Trinea
Facebook: Dev Tools