LoadingButtonAndroid 开源项目教程

1. 项目介绍

LoadingButtonAndroid 是一个用于 Android 平台的开源库，它提供了一个可以替代传统 ProgressDialog 的按钮组件。该按钮在点击后可以变形为加载进度条，并在加载完成后显示完成动画。这个库完全可以在 XML 中进行自定义，使用起来非常简单，能够让你的应用界面看起来更加酷炫。

主要功能

• 按钮变形：按钮可以变形为加载进度条。
• 完全自定义：可以在 XML 中自定义按钮的外观和行为。
• 动画控制：支持加载动画、完成动画和回退动画。
• 避免内存泄漏：提供了避免内存泄漏的机制。

2. 项目快速启动

安装

首先，在你的 build.gradle 文件中添加依赖：

implementation("com.github.leandroborgesferreira:loading-button-android:2.3.0")

使用

在你的布局文件中添加 CircularProgressButton：

<com.github.leandroborgesferreira.loadingbutton.customViews.CircularProgressButton
    android:id="@+id/btn_id"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:background="@drawable/circular_border_shape"
    app:spinning_bar_width="4dp"
    app:spinning_bar_color="#FFF"
    app:spinning_bar_padding="6dp" />

在你的 Activity 或 Fragment 中实例化按钮并启动动画：

CircularProgressButton btn = findViewById(R.id.btn_id);
btn.startAnimation();

// 异步任务完成后
btn.doneLoadingAnimation(fillColor, bitmap);

// 或者回退动画
btn.revertAnimation();

3. 应用案例和最佳实践

案例1：登录按钮

在登录界面中，用户点击登录按钮后，按钮可以变形为加载进度条，表示正在处理登录请求。登录成功后，按钮显示完成动画，表示登录成功。

btn.setOnClickListener(v -> {
    btn.startAnimation();
    // 模拟异步登录请求
    new Handler().postDelayed(() -> {
        btn.doneLoadingAnimation(Color.GREEN, BitmapFactory.decodeResource(getResources(), R.drawable.ic_done));
    }, 2000);
});

案例2：提交表单

在表单提交界面中，用户点击提交按钮后，按钮变形为加载进度条，表示正在提交表单。提交成功后，按钮显示完成动画，表示提交成功。

btn.setOnClickListener(v -> {
    btn.startAnimation();
    // 模拟异步提交请求
    new Handler().postDelayed(() -> {
        btn.doneLoadingAnimation(Color.BLUE, BitmapFactory.decodeResource(getResources(), R.drawable.ic_done));
    }, 2000);
});

4. 典型生态项目

1. Android-Morphing-Button

Android-Morphing-Button 是另一个类似的开源项目，它也提供了按钮变形为加载进度条的功能。虽然功能相似，但 LoadingButtonAndroid 在易用性和自定义性上更为出色。

2. MaterialProgressBar

MaterialProgressBar 是一个专注于 Material Design 风格进度条的开源库。虽然它主要用于显示进度条，但与 LoadingButtonAndroid 结合使用，可以进一步提升用户体验。

3. Android-SpinKit

Android-SpinKit 是一个提供多种加载动画的开源库。它可以与 LoadingButtonAndroid 结合使用，为按钮提供更多样化的加载动画效果。

通过这些生态项目的结合，开发者可以构建出更加丰富和动态的用户界面。