https://github.com/chinnsenn/submitbutton
A custom buttom with progress
https://github.com/chinnsenn/submitbutton
kotlin submitbutton
Last synced: 13 days ago
JSON representation
A custom buttom with progress
- Host: GitHub
- URL: https://github.com/chinnsenn/submitbutton
- Owner: chinnsenn
- License: mit
- Created: 2018-10-24T13:26:05.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2022-05-27T03:24:06.000Z (over 3 years ago)
- Last Synced: 2023-06-30T01:01:31.340Z (over 2 years ago)
- Topics: kotlin, submitbutton
- Language: Kotlin
- Homepage:
- Size: 235 KB
- Stars: 40
- Watchers: 2
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 自定义带进度圈的按钮 SubmitButton (kotlin)
---
![Android][1]
## 使用方法
0、在工程根目录 build.gradle 中添加
```
allprojects {
repositories {
google()
mavenCentral() //0.2.2 开始
}
}
```
1、在 gradle 里引用: [这里查看最新版本号][2]
```gradle
implementation 'com.chinnsenn:submitbutton:#last_version'
```
2、在 xml 中添加控件
```xml
```
- 属性也可以在代码中设置
```kotlin
val submitButton:SubmitButton = findViewById(R.id.submitbutton)
submitButton.submitText = "开始上传"
submitButton.completeText = "上传完成"
submitButton.failureText = "上传失败"
submitButton.unKnownProgress = false
```
属性介绍
| 属性名 | 描述 |
| --- | --- |
| buttonColor | 按钮颜色 |
| buttonStrokeWidth | 线框宽度 |
| buttonTextSize | 按钮文字大小 |
| completeText | 完成文案 |
| failureText | 失败文案 |
| progressColor | 进度条颜色 |
| submitText | 起始文字 |
| unKnownProgress | 不能确定进度 |
## 两种进度条
- 不确定进度（默认）
`submitButton.unKnownProgress = true`
这种情况下需要手动调用 SubmitButton#stop() 方法结束转进度
---
- 可以确定进度
### 不需要调用 SubmitButton#stop()
`submitButton.unKnownProgress = false`
但需要在你网络请求进度中或者其他地方调用
```SubmitButton#setProgress(percent:Float) //需要你计算好百分比```
或者
```SubmitButton#setProgressAndTotal(progress: Float, total: Float) //传入当前数值和总进度```
否则进度圈不会变化。
## 失败状态
在网络请求失败的回调里调用 SubmitButton#failure()
![失败][3]
此控件为还原 Dribble 上一个动效而制作
![Dribble][4]
## 更新日志
- v0.2.0 新增具体进度数字（确定进度状态下）
- v0.2.0.1 修改 onComplete() 调用时机，在 EndAnimator#onAnimationEnd()中调用
- v0.2.3 托管库移动到 mavenCentral
## 更新计划
* [ ] 支持使用背景selector ([issues#1][5])
* [ ] 更多自定义参数
---
因为没有具体参数，只能摸索的仿造，而且没有使用场景可能导致兼容性不好，有许多不足之处，也欢迎PR。
[1]: https://raw.githubusercontent.com/chinnsenn/BlogFigureBed/master/blogimg/006tNbRwgy1fwvyecvoq9g30mi05kk9f.gif
[2]: https://github.com/foreveronly/SubmitButton/releases
[3]: https://raw.githubusercontent.com/chinnsenn/BlogFigureBed/master/blogimg/006tNbRwly1fwscfx487hg30mi05ktow.gif
[4]: https://raw.githubusercontent.com/chinnsenn/BlogFigureBed/master/blogimg/006tNbRwly1fwscfvvrkgg30mi05kdsm.gif
[5]: https://github.com/foreveronly/SubmitButton/issues/1