10个CircularProgressView实战案例：从加载动画到进度显示

10个CircularProgressView实战案例：从加载动画到进度显示

【免费下载链接】CircularProgressViewMaterial style circular progress bar for Android项目地址: https://gitcode.com/gh_mirrors/ci/CircularProgressView

CircularProgressView是一款为Android开发者打造的Material风格圆形进度条组件，它提供了丰富的自定义选项和流畅的动画效果，能够轻松实现各种进度展示需求。无论是应用加载状态、文件下载进度还是操作等待提示，这款轻量级组件都能为你的应用界面增添专业感和现代美感。

1. 基础加载动画实现

最常见的使用场景是作为应用或页面的加载指示器。通过设置setIndeterminate(true)，可以启用无限循环的旋转动画，为用户提供直观的加载状态反馈。

核心代码实现：

CircularProgressView progressView = findViewById(R.id.progress_view); progressView.setIndeterminate(true); // 启用不确定模式 progressView.startAnimation(); // 开始动画

2. 文件下载进度展示

在文件下载、数据同步等场景中，确定模式的进度条能够清晰展示完成百分比。通过setProgress()方法动态更新进度值，结合getMaxProgress()设置总量，实现精确的进度反馈。

关键方法：

progressView.setIndeterminate(false); // 切换到确定模式 progressView.setMaxProgress(100); // 设置最大进度值 progressView.setProgress(35); // 更新当前进度为35%

3. 自定义进度条颜色

通过setColor()方法可以轻松修改进度条颜色，使其与应用主题保持一致。支持直接传入颜色值或使用资源文件中定义的颜色，满足不同场景下的视觉需求。

实现代码：

// 使用资源颜色 progressView.setColor(getResources().getColor(R.color.accent_color)); // 直接使用RGB颜色值 progressView.setColor(Color.parseColor("#FF4081"));

4. 调整进度条粗细

setThickness()方法允许你控制进度条的线条粗细，从纤细的精致风格到粗体的醒目设计，都可以一键实现。参数接受像素值，建议使用dp单位转换确保不同设备上的一致性。

粗细调整：

// 将2dp转换为像素值设置进度条粗细 int thickness = (int) TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP, 2, getResources().getDisplayMetrics()); progressView.setThickness(thickness);

5. 启动页加载动画

在应用启动过程中，结合setIndeterminate(true)和setProgress()实现从加载动画到完成状态的平滑过渡，提升用户体验。

实现思路：

1. 启动时设置为不确定模式展示加载动画
2. 加载完成后切换到确定模式并设置进度为100%
3. 完成后自动隐藏或跳转页面

6. 分步操作进度指示

对于多步骤流程（如注册、设置向导），可以使用确定模式的进度条显示当前完成的步骤比例，帮助用户了解整体进度。

实现示例：

// 共5个步骤，完成第2步 progressView.setMaxProgress(5); progressView.setProgress(2);

7. 自定义起始角度

通过设置起始角度可以改变进度条的动画起点，默认从顶部(0度)开始，你可以根据设计需求调整为从左侧(90度)或其他任意角度开始。

角度调整：

// 在XML布局中设置 app:cpv_startAngle="90" // 或在代码中设置 progressView.setStartAngle(90);

8. 结合监听器实现交互反馈

使用addListener()方法注册进度变化监听器，实现在进度完成、模式切换等事件发生时的自定义操作，如隐藏进度条、显示完成提示等。

监听器使用：

progressView.addListener(new CircularProgressViewListener() { @Override public void onProgressUpdateEnd(float currentProgress) { if (currentProgress == progressView.getMaxProgress()) { // 进度完成，执行操作 Toast.makeText(context, "加载完成", Toast.LENGTH_SHORT).show(); } } });

9. 列表项加载状态

在RecyclerView或ListView中，为每个列表项添加小型CircularProgressView，用于展示该项的加载或处理状态，提供更精细的用户反馈。

布局示例：

<com.github.rahatarmanahmed.cpv.CircularProgressView android:id="@+id/item_progress" android:layout_width="24dp" android:layout_height="24dp" app:cpv_thickness="2dp" app:cpv_color="@color/primary" />

10. 按钮点击加载状态

将CircularProgressView与按钮结合，在用户点击后显示加载状态，防止重复点击，并提供操作进行中的视觉反馈。

实现步骤：

1. 在按钮点击事件中显示进度条
2. 禁用按钮交互
3. 操作完成后隐藏进度条并恢复按钮状态

快速集成指南

要在你的项目中使用CircularProgressView，只需几步简单操作：

1. 克隆仓库到本地

git clone https://gitcode.com/gh_mirrors/ci/CircularProgressView

2. 在布局文件中添加组件

<com.github.rahatarmanahmed.cpv.CircularProgressView android:id="@+id/circularProgress" android:layout_width="48dp" android:layout_height="48dp" app:cpv_color="@color/accent" app:cpv_thickness="4dp" />

3. 在代码中控制进度条

CircularProgressView progressView = findViewById(R.id.circularProgress); progressView.setIndeterminate(true); progressView.startAnimation();

CircularProgressView的核心实现位于circularprogressview/src/main/java/com/github/rahatarmanahmed/cpv/CircularProgressView.java，你可以通过阅读源码了解更多高级自定义选项和实现细节。

无论是简单的加载动画还是复杂的进度展示，CircularProgressView都能提供流畅、美观的解决方案，为你的Android应用增添专业的Material设计风格。

【免费下载链接】CircularProgressViewMaterial style circular progress bar for Android项目地址: https://gitcode.com/gh_mirrors/ci/CircularProgressView