推荐使用LoadingLayout：简化Android页面状态管理

农烁颖Land

于 2024-09-03 10:09:13 发布

阅读量419

点赞数 3

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00297/article/details/141853779

推荐使用LoadingLayout：简化Android页面状态管理

loadinglayout简单实用的页面多状态布局(content,loading,empty,error) 项目地址:https://gitcode.com/gh_mirrors/lo/loadinglayout

项目介绍

在移动应用开发中，页面状态管理是一个常见但又繁琐的任务。无论是加载中、空数据、错误还是内容展示，都需要开发者精心设计和管理。为了简化这一过程，LoadingLayout应运而生。这是一个简单实用的开源项目，旨在帮助开发者轻松管理页面的多种状态，包括内容、加载中、空数据和错误状态。

项目技术分析

LoadingLayout通过提供一个灵活的布局容器，允许开发者根据需要切换不同的页面状态。项目支持通过XML布局文件直接定义状态布局，也支持在Java代码中动态设置和切换状态。此外，LoadingLayout还提供了丰富的自定义选项，包括图片、文本、颜色和尺寸等，以满足不同设计需求。

项目及技术应用场景

LoadingLayout适用于所有需要管理页面状态的Android应用场景。无论是电商应用、新闻阅读器还是社交平台，都可以利用LoadingLayout来提升用户体验。例如，在加载数据时显示加载动画，数据为空时显示提示信息，网络错误时显示错误页面并提供重试按钮。

项目特点

简单易用：通过简单的API调用即可切换不同的页面状态，无需复杂的逻辑处理。
高度自定义：支持通过XML和Java代码自定义各种状态的布局和样式。
灵活性强：既可以在布局文件中直接使用，也可以在代码中动态包裹和替换内容元素。
开源免费：基于Apache 2.0许可证，开发者可以自由使用和修改。

使用指南

Gradle依赖

首先，在项目的build.gradle文件中添加JitPack仓库：

repositories { 
    maven { url "https://jitpack.io" }
}

然后在模块的build.gradle文件中添加依赖：

dependencies {
    implementation 'com.github.czy1121:loadinglayout:1.0.1'
}

在主题中设置默认样式

在styles.xml中定义LoadingLayout的默认样式：

<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
    ...
    <item name="styleLoadingLayout">@style/LoadingLayoutStyle</item>
</style>

<style name="LoadingLayoutStyle" parent="LoadingLayout.Style">
    <item name="llEmptyImage">@mipmap/empty</item>
    <item name="llErrorImage">@mipmap/error</item>
    ...
</style>

在布局中使用

在XML布局文件中直接使用LoadingLayout：

<ezy.ui.layout.LoadingLayout
    android:id="@+id/loading"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <TextView
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:gravity="center"
        android:text="This is Content"/>
        
</ezy.ui.layout.LoadingLayout>

包裹并替换内容元素

在Java代码中动态包裹和替换内容元素：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    
    // ...
    
    vLoading = LoadingLayout.wrap(this); 
    vLoading.showContent(); 
    
    // ...
}

API调用

通过API调用切换不同的页面状态：

// 显示 content/loading/empty/error 布局
showContent()
showLoading()
showEmpty()
showError()

// 设置 loading/empty/error 布局
setLoading(int resId)
setEmpty(int resId)
setError(int resId)

// 设置空布局的图片与文本
setEmptyImage(int resId)
setEmptyText(String value)

// 设置错误布局的图片与文本，
setErrorImage(int resId)
setErrorText(String value) 

// 设置重试按钮文本
setRetryText(String value)

// 设置重试按钮的监听回调
setRetryListener(OnClickListener listener)