LoadingButtonAndroid 开源项目教程

2024-09-25 04:12:17作者：伍希望

LoadingButtonAndroid 是一个强大的开源项目，专为 Android 开发者设计。它提供了一个可自定义的按钮，能够在点击后变形为加载进度条，完成后还可显示“完成”动画。使用简单，只需几行代码即可集成到你的应用中，让你的应用界面更加酷炫和用户友好。支持多种动画效果和状态切换，是提升用户体验的理想选择。

项目地址：https://gitcode.com/gh_mirrors/lo/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);
});