/JProgressView

一个灵活的进度条,支持图形:圆形、圆角矩形、矩形等等,陆续会添加更多的图形,如果对你有帮助,请在右上角 star 一下,感谢

Primary LanguageKotlin

JProgressView

如果这个仓库对你有帮助,请仓库右上角帮我 star 一下

一个小巧灵活可定制的进度条,支持图形:圆形、圆角矩形、矩形等等,陆续会添加更多的图形

JProgressView 包含以下功能

  • 支持在 XML 中配置是否自动播放动画(true : 当 view 可见的时候会自动播放动画)
  • 支持自定义图形:圆形、圆角矩形、矩形
  • 支持代码和 XML 设置进度条属性;同时设置代码会覆盖 XML 设置的属性
  • 支持设置文字是否显示,文字距离进度条的位置、大小、颜色等等
  • 支持设置进度的的颜色,当前进度值、进度的最大值、动画运行时间等等
  • 更多功能正在开发中......

Download

  • 将下列代码添加在项目 build.gradle 文件内
allprojects {
    repositories {
        jcenter()
    }
}
  • 将下列代码添加进模块 build.gradle 文件内
dependencies {
    implementation 'com.hi-dhl:progressview:1.0.2'
}

Usage

1.在 layout 文件内添加以下命名空间

xmlns:app="http://schemas.android.com/apk/res-auto"

2.实现一个进度条基本示例

<com.hi.dhl.jprogressview.JProgressView
    android:id="@+id/circleProgresssView0"
    android:layout_width="match_parent"
    android:layout_height="20dp"
    app:progress_animate_duration="1500"
    app:progress_color="@color/progress_color"
    app:progress_color_background="@color/progress_color_background"
    app:progress_paint_bg_width="@dimen/progress_paint_width"
    app:progress_paint_value_width="@dimen/progress_paint_width"
    app:progress_rect_text_align="1"
    app:progress_text_color="@color/progress_text_color"
    app:progress_text_size="@dimen/text_size_14sp"
    app:progress_text_visible="true"
    app:progress_type="2"
    app:progress_value="40"
    app:progress_rect_radius="8dp"
    app:progress_value_max="100" />

通用属性,适合所有形状的进度条:

名称 值类型 默认值 备注
progress_type integer 圆形:1 矩形:0;圆形:1;圆角矩形:2
progress_animate_duration integer 2000 动画运行时间
progress_color color Color.GRAY 当前进度颜色
progress_color_background color Color.GRAY 进度条背景颜色
progress_paint_bg_width dimen 10 进度条背景画笔的宽度
progress_paint_value_width dimen 10 当前进度画笔的宽度
progress_text_color color Color.BLUE 进度条上的文字的颜色
progress_text_size dimen sp2Px(20f) 进度条上的文字的大小
progress_text_visible boolean 默认不显示:false 是否显示文字
progress_value integer 0 当前进度
progress_value_max integer 100 当前进度条的最大值
progress_start_animate boolean 默认不自动开启:false 是否开动画自动播放

以下属性,矩形 或者 圆角矩形进度条专有属性:

名称 值类型 默认值 备注
progress_rect_text_align integer 中间:1 文字位于进度条位置(左边:0;中间:1;右边:2)
progress_rect_radius dimen 0 进度条圆角

以下属性,圆形进度条专有属性:

名称 值类型 默认值 备注
progress_circle_sweep_angle integer top:1 进度条开始角度(left:0;top:1;right:2;bottom:3)

开启或停止动画

默认不开启动画,在需要开启动画的地方调用以下代码:

circleProgresssView0.startAnimal()

调用以下代码停止动画:

progresssView.stopAnimal()

还可以通过代码设置进度条一些属性,代码会覆盖 XML 设置的属性

progresssView
    .setProgress(0f)// 当前进度
    .setMaxProgress(100)// 进度条的最大值
    .setReverse(false)// 进度条回放
    .setAnimateDuration(1000)// 动画运行时间
    .isShowText(true)// 是否显示文字
    .setProgressColor(resources.getColor(R.color.progress_color, null))// 当前进度颜色
    .setProgressColorBackground(resources.getColor(R.color.progress_color_background, null))// 进度条背景颜色
    .setRectRadius(resources.getDimension(R.dimen.common_radius_8dp))// 圆角
    .setRectTextAlign(1)// 文字位于进度条位置(左边:0;中间:1;右边:2)
    .setTextColor(resources.getColor(R.color.progress_text_color, null))// 文字颜色
    .setTextSize(resources.getDimension(R.dimen.text_size_14sp))// 文字大小
    .setShapeType(2)// 形状: 矩形:0;圆形:1;圆角矩形:2
    .setProgressPaintBackgroundWidth(resources.getDimension(R.dimen.progress_paint_width))// 进度条背景画笔的宽度
    .setProgressPaintWidth(resources.getDimension(R.dimen.progress_paint_width))// 当前进度画笔的宽度
    .resetValue()// 通过代码设置完属性之后,需要调用,重新绘制

未来还未支持更多自定义图形,请持续关注,如果这个仓库对你有帮助,请仓库右上角帮我 star 一下。


最后推荐我一直在更新维护的项目和网站:

  • 计划建立一个最全、最新的 AndroidX Jetpack 相关组件的实战项目 以及 相关组件原理分析文章,正在逐渐增加 Jetpack 新成员,仓库持续更新,欢迎前去查看:AndroidX-Jetpack-Practice

  • LeetCode / 剑指 offer / 国内外大厂面试题 / 多线程 题解,语言 Java 和 kotlin,包含多种解法、解题思路、时间复杂度、空间复杂度分析

  • 最新 Android 10 源码分析系列文章,了解系统源码,不仅有助于分析问题,在面试过程中,对我们也是非常有帮助的,仓库持续更新,欢迎前去查看 Android10-Source-Analysis

  • 整理和翻译一系列精选国外的技术文章,每篇文章都会有译者思考部分,对原文的更加深入的解读,仓库持续更新,欢迎前去查看 Technical-Article-Translation

  • 「为互联网人而设计,国内国外名站导航」涵括新闻、体育、生活、娱乐、设计、产品、运营、前端开发、Android 开发等等网址,欢迎前去查看 为互联网人而设计导航网站