MNProgressHUD 使用指南

MNProgressHUD 使用指南

MNProgressHUD一个常用的自定义弹框封装(适配AndroidX),加载ProgressDialog,状态显示的StatusDialog和自定义Toast,全部支持背景颜色,圆角,边框和文字的自定义,构建者模式,链式调用。项目地址:https://gitcode.com/gh_mirrors/mn/MNProgressHUD

---

1. 项目介绍

MNProgressHUD 是一款专为 Android 应用设计的自定义对话框库，它提供了丰富的加载指示器以及自定义 Toast 的能力。此库完全基于构建者模式，允许链式调用，便于开发者定制化地展示进度对话框、状态对话框及自定义的提示信息。MNProgressHUD 不仅支持背景颜色、圆角、边框和文字的个性化设定，而且完美适配了 AndroidX，确保在不同版本的 Android 上都能提供一致且美观的用户体验。

---

2. 项目快速启动

添加依赖

首先，在你的项目的 build.gradle(Module级别) 文件的 dependencies 中加入以下依赖：

dependencies {
    implementation 'com.github.maning0303:MNProgressHUD:latest.version'
}

将 latest.version 替换为实际的最新版本号，你可以从 GitHub releases 页面找到最新的版本信息。

显示基本进度条

展示一个简单的进度条对话框，可以通过以下代码实现：

MProgressDialog dialog = new MProgressDialog.Builder(context)
        .setMessage("加载中...")
        .setProgress(0)
        .show();

如果你想添加动画效果，可以这样写：

MProgressDialog.showProgress(50, 0, "正在加载", true);

自定义 Toast

快速创建一个自定义样式 Toast:

MToastConfig config = new MToastConfig.Builder()
        .setTextColor getResources().getColor(R.color.colorAccent))
        .setBackgroundColor(getResources().getColor(R.color.colorDialogTest))
        .setTextSize(15f)
        .build();

MToast.makeTextShort(context, "这是一个自定义 Toast", config).show();

---

3. 应用案例和最佳实践

实时进度更新

当你需要在文件上传或下载过程中显示实时进度，可以这样做：

// 假设progress是变化的值
int progress = calculateCurrentProgress();
MProgressDialog.updateProgress(progress);

自定义样式适应主题

为了使对话框的风格与你的应用主题保持一致，可以在创建对话框时，根据当前的主题选择合适颜色和样式，例如：

MProgressDialog.Builder(context)
    .setBackgroundColor(getMyColor(R.color.dialogWindowBg))
    .setTextColor(getMyColor(R.color.textColor))
    .build();

---

4. 典型生态项目

MNProgressHUD 在设计上考虑到了与现有组件的融合，虽然项目本身专注于对话框和Toast的定制，但它可以很容易地集成进各种场景，比如结合MVP架构的项目GankMM，用于版本更新的MNUpdateAPK，或者是图片浏览库MNImageBrowser。这些生态项目展示了MNProgressHUD如何在更复杂的应用环境中发挥其灵活性和实用性。

通过利用MNProgressHUD的自定义能力和简洁的API，开发者能够轻松提升应用的用户界面体验，无论是快速反馈还是长时间的操作等待，都能做到既美观又高效。

---

以上就是MNProgressHUD的快速上手和高级使用的简要介绍。实践中，开发者可以根据具体需求灵活调整参数，打造符合应用个性的UI体验。

MNProgressHUD一个常用的自定义弹框封装(适配AndroidX),加载ProgressDialog,状态显示的StatusDialog和自定义Toast,全部支持背景颜色,圆角,边框和文字的自定义,构建者模式,链式调用。项目地址:https://gitcode.com/gh_mirrors/mn/MNProgressHUD