Android Circular Progress Button 教程

Android Circular Progress Button 教程

1. 项目介绍

Android Circular Progress Button 是一个专为Android设计的开源库，它允许开发者创建具有美观状态动画切换的按钮。这个库主要用来实现一种按钮，当点击后，按钮会变为一个显示进度的环形动画，适用于图片上传、下载或其他需要显示进行中的操作的场景。完成或失败时，按钮还会显示成功的勾号或错误的叉号图标。

项目主页：https://github.com/dmytrodanylyk/circular-progress-button

2. 项目快速启动

添加依赖

首先，在你的 build.gradle 文件（app级别）中添加以下依赖：

dependencies {
    implementation 'com.github.dmytrodanylyk:circular-progress-button:1.1.0'
}

然后同步项目以下载库。

使用 Circular Progress Button

在你的布局XML文件中添加 Circular Progress Button：

<com.dd.CircularProgressButton
    android:id="@+id/btnWithText"
    app:cpb_color="#FF4081"
    app:cpb_stroke_width="3dp"
    app:cpb_text="Submit"
    app:cpb_progress="60"/>

初始化并处理点击事件：

CircularProgressButton btnWithText = findViewById(R.id.btnWithText);
btnWithText.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View v) {
        // 开始加载进度
        btnWithText.setProgressAndShowProgress(0);
        
        // 在这里执行异步任务，完成后更新进度
        // ...
        
        // 当任务完成后
        btnWithText.setProgressAndHideProgress(100);
    }
});

3. 应用案例和最佳实践

• 登录和注册：在用户输入完凭证并点击登录或注册按钮后，显示环形进度表示验证过程。
• 提交表单：提交包含多步骤的数据时，如调查问卷或订单，按钮可展示当前进度。
• 文件上传或下载：在文件传输过程中，用户可以看到按钮上的进度变化。

最佳实践：

• 保持进度条颜色与主题一致，确保视觉一致性。
• 根据实际情况调整进度动画速度，确保用户感知到操作正在进行但不会过于等待。
• 完成或失败状态显示时间应足够长，以便用户注意到。

4. 典型生态项目

该项目被广泛应用于多个Android应用，包括但不限于以下项目：

• 自定义App的提交、分享和保存功能。
• 第三方库集成，例如网络请求库，用于提供UI反馈。
• 开源示例项目，用于展示如何优雅地处理按钮状态转换。

若要了解更多实际应用场景，可以浏览GitHub仓库中的示例项目和社区贡献者们的项目。