hkm-progress-button 开源项目教程
项目介绍
hkm-progress-button
是一个基于 android-process-button
的进阶版本,提供了多种带有内置进度指示器的 Android 按钮。该项目在 GitHub 上开源,由 jjhesk 维护,拥有 118 颗星和 15 个 forks。
项目快速启动
添加依赖
首先,在你的 build.gradle
文件中添加以下依赖:
dependencies {
implementation 'com.github.jjhesk:hkm-progress-button:1.0.0'
}
布局文件
在你的布局文件中添加 ActionProcessButton
:
<com.dd.processbutton.iml.ActionProcessButton
android:id="@+id/btn_confirm"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="Confirm"
app:pb_colorProgress="@color/colorProgress"
app:pb_colorComplete="@color/colorComplete"
app:pb_colorError="@color/colorError"
app:pb_textProgress="Processing..."
app:pb_textComplete="Completed"
app:pb_textError="Error" />
代码实现
在你的 Activity 或 Fragment 中,初始化和控制按钮:
ActionProcessButton btnConfirm = findViewById(R.id.btn_confirm);
btnConfirm.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
btnConfirm.setProgress(1); // 设置进度
// 模拟处理
new Handler().postDelayed(new Runnable() {
@Override
public void run() {
btnConfirm.setProgress(100); // 完成
}
}, 2000);
}
});
应用案例和最佳实践
案例一:表单提交
在表单提交场景中,使用 ActionProcessButton
可以直观地展示提交进度和结果,提升用户体验。
案例二:文件上传
在文件上传功能中,按钮可以实时显示上传进度,并在上传完成后显示成功或失败状态。
最佳实践
- 确保按钮的文本和颜色与应用的整体风格一致。
- 在处理长时间任务时,使用
setProgress
方法更新进度,避免用户界面卡顿。
典型生态项目
相关项目
android-process-button
: 基础版本,提供了基本的进度按钮功能。FlatButton
: 提供了扁平化风格的按钮,与hkm-progress-button
结合使用,可以实现更多样化的按钮效果。
通过以上教程,你可以快速上手并应用 hkm-progress-button
项目,提升你的 Android 应用的用户体验。