RoundCornerProgressBar
Round corner is cool. Let's make your progress bar to round corner
Colorful progress bar with round corner on progress which you can customized a color and corner radius
Installation
implementation 'com.akexorcist:round-corner-progress-bar:2.1.1'
Migrate from 2.0.x to 2.1.x or higher
Moving from MavenCentral to JCenter with new artifact ID
From (MavenCentral)
// Old (MavenCentral)
implementation 'com.akexorcist:RoundCornerProgressBar:2.0.3'
// New (JCenter)
implementation 'com.akexorcist:round-corner-progress-bar:2.1.1'
BaseRoundCornerProgressBar.OnProgressChangedListener
Change the view ID parameter in onProgressChanged
to View class
// Old
fun onProgressChanged(
viewId: Int,
progress: Float,
isPrimaryProgress: Boolean,
isSecondaryProgress: Boolean
)
// New
fun onProgressChanged(
view: View,
progress: Float,
isPrimaryProgress: Boolean,
isSecondaryProgress: Boolean
)
Custom your own progress bar by extends BaseRoundCornerProgressBar
Use AnimatedRoundCornerProgressBar instead of BaseRoundCornerProgressBar for progress change animation support.
class CustomRoundCornerProgressBar: AnimatedRoundCornerProgressBar() {
...
}
And you do not have to create the GradientDrawable
by yourself anymore. drawProgress
will send it as parameter.
// Old
fun drawProgress(
layoutProgress: LinearLayout,
max: Float,
progress: Float,
totalWidth: Float,
radius: Int,
padding: Int,
progressColor: Int,
isReverse: Boolean
)
// New
fun drawProgress(
layoutProgress: LinearLayout,
progressDrawable: GradientDrawable,
max: Float,
progress: Float,
totalWidth: Float,
radius: Int,
padding: Int,
isReverse: Boolean
)
Release Notes
2.1.1
2.1.0
CenteredRoundCornerProgressBar
added (#42)IndeterminateRoundCornerProgressBar
andIndeterminateCenteredRoundCornerProgressBar
addedIconRoundCornerProgressBar
now support forBitmap
andDrawable
for icon- Animation for progress update (disable by default) added. This feature applied to all progress bars
- Gradient progress color support (both primary and secondary progress) added. This feature applied to all progress bars ((#39))
- Text gravity when inside/outside and text position priority attribute in
TextRoundCornerProgressBar
added - Integer value support for progress setter (convert to float inside) added
- Update to Gradle Plugin 3.6.3 and Gradle 5.6.4
- Migrate from Android Support to AndroidX
- Still in Java! (will be Kotlin in next version)
- Fix bug in (#43) (#20) (#74)
- Moved from MavenCentral to JCenter. Please see "Installation" section for new artifact ID
- All new sample code. You should try it!
- Add useful annotations for Kotlin
2.0.X
- New code structure, Easy for further development
Demo
Overview
Round Corner Progress Bar
Simple round corner progress bar
CenteredRoundCornerProgressBar
Round corner progress bar with progress expands from the center
Icon Round Corner Progress Bar
Round corner progress bar with heading icon
TextRoundCornerProgressBar
Round corner progress bar with text inside the progress
IndeterminateRoundCornerProgressBar and IndeterminateCenteredRoundCornerProgressBar
Simple round corner progress bar and centered round corner progress bar with indeterminate animation
Feature
Standard Features
- Primary progress and secondary progress supported
- Primary progress, secondary progress and progress background color are customizable
- Customize your own progress background padding
- Customize your own progress's corner radius
- Reversing progress bar supported
- Progress bar with gradient color? Yes!
- Progress change animation? Absolutely yes!
Component Features
- Progress expanding from center with
CenteredRoundCornerProgressBar
- Heading icon supported with
IconRoundCornerProgressBar
- Text inside progress supported with
TextRoundCornerProgressBar
- Indeterminate animation supported with
IndeterminateRoundCornerProgressBar
orIndeterminateCenteredRoundCornerProgressBar
Usage
For using custom attribute of progress bar, define 'app' namespace as root view attribute in your layout
xmlns:app="http://schemas.android.com/apk/res-auto"
RoundCornerProgressBar
Example
<com.akexorcist.roundcornerprogressbar.IconRoundCornerProgressBar
android:layout_width="260dp"
android:layout_height="30dp"
app:rcBackgroundColor="#0A000000"
app:rcBackgroundPadding="2dp"
app:rcMax="100"
app:rcProgress="40"
app:rcProgressColor="#EF5350"
app:rcRadius="10dp"
app:rcSecondaryProgress="60"
app:rcSecondaryProgressColor="#40EF5350" />
Layout XML
<com.akexorcist.roundcornerprogressbar.RoundCornerProgressBar
app:rcProgress="float"
app:rcSecondaryProgress="float"
app:rcMax="float"
app:rcRadius="dimension"
app:rcBackgroundPadding="dimension"
app:rcReverse="boolean"
app:rcProgressColor="color"
app:rcSecondaryProgressColor="color"
app:rcBackgroundColor="color"
app:rcAnimationEnable="boolean"
app:rcAnimationSpeedScale="float" />
Public Methods
// Progress
fun getMax(): Float
fun setMax(max: Float)
fun getProgress(): Float
fun setProgress(progress: Int)
fun setProgress(progress: Float)
fun getSecondaryProgress(): Float
fun setSecondaryProgress(secondaryProgress: Int)
fun setSecondaryProgress(secondaryProgress: Float)
// Dimension
fun getRadius(): Int
fun setRadius(radius: Int)
fun getPadding(): Int
fun setPadding(padding: Int)
fun getLayoutWidth(): Float
// Animation
fun enableAnimation()
fun disableAnimation()
fun getAnimationSpeedScale(): Float
fun setAnimationSpeedScale(scale: Float)
fun isProgressAnimating(): Boolean
fun isSecondaryProgressAnimating(): Boolean
// Reversing Progress
fun isReverse(): Boolean
fun setReverse(isReverse: Boolean)
// Color
fun getProgressBackgroundColor(): Int
fun setProgressBackgroundColor(color: Int)
fun getProgressColor(): Int
fun setProgressColor(color: Int)
fun getProgressColors(): IntArray
fun setProgressColors(colors: IntArray)
fun getSecondaryProgressColor(): Int
fun setSecondaryProgressColor(color: Int)
fun getSecondaryProgressColors(): IntArray
fun setSecondaryProgressColors(colors: IntArray)
// Listener
fun setOnProgressChangedListener(listener: OnProgressChangedListener)
CenteredRoundCornerProgressBar
Same as RoundCornerProgressBar but reversing does not supported.
Example
<com.akexorcist.roundcornerprogressbar.CenteredRoundCornerProgressBar
android:layout_width="260dp"
android:layout_height="30dp"
app:rcBackgroundColor="#0A000000"
app:rcBackgroundPadding="2dp"
app:rcMax="100"
app:rcProgress="40"
app:rcProgressColor="#EF5350"
app:rcRadius="10dp"/>
Layout XML
<com.akexorcist.roundcornerprogressbar.CenteredRoundCornerProgressBar
app:rcProgress="float"
app:rcSecondaryProgress="float"
app:rcMax="float"
app:rcRadius="dimension"
app:rcBackgroundPadding="dimension"
app:rcProgressColor="color"
app:rcSecondaryProgressColor="color"
app:rcBackgroundColor="color"
app:rcAnimationEnable="boolean"
app:rcAnimationSpeedScale="float" />
Public Methods
// Progress
fun getMax(): Float
fun setMax(max: Float)
fun getProgress(): Float
fun setProgress(progress: Int)
fun setProgress(progress: Float)
fun getSecondaryProgress(): Float
fun setSecondaryProgress(secondaryProgress: Int)
fun setSecondaryProgress(secondaryProgress: Float)
// Dimension
fun getRadius(): Int
fun setRadius(radius: Int)
fun getPadding(): Int
fun setPadding(padding: Int)
fun getLayoutWidth(): Float
// Animation
fun enableAnimation()
fun disableAnimation()
fun getAnimationSpeedScale(): Float
fun setAnimationSpeedScale(scale: Float)
fun isProgressAnimating(): Boolean
fun isSecondaryProgressAnimating(): Boolean
// Color
fun getProgressBackgroundColor(): Int
fun setProgressBackgroundColor(color: Int)
fun getProgressColor(): Int
fun setProgressColor(color: Int)
fun getProgressColors(): IntArray
fun setProgressColors(colors: IntArray)
fun getSecondaryProgressColor(): Int
fun setSecondaryProgressColor(color: Int)
fun getSecondaryProgressColors(): IntArray
fun setSecondaryProgressColors(colors: IntArray)
// Listener
fun setOnProgressChangedListener(listener: OnProgressChangedListener)
IconRoundCornerProgressBar
Icon size is required for this progress bar. Use wrap_content
for layout_height
is recommended.
<com.akexorcist.roundcornerprogressbar.IconRoundCornerProgressBar
android:layout_height="wrap_content"
app:rcIconSize="40dp"
... />
Example
<com.akexorcist.roundcornerprogressbar.IconRoundCornerProgressBar
android:layout_width="260dp"
android:layout_height="wrap_content"
app:rcBackgroundColor="#0A000000"
app:rcBackgroundPadding="2dp"
app:rcIconBackgroundColor="#00796B"
app:rcIconPadding="5dp"
app:rcIconSize="40dp"
app:rcIconSrc="@drawable/ic_android"
app:rcMax="150"
app:rcProgress="90"
app:rcProgressColor="#EF5350"
app:rcRadius="5dp"
app:rcReverse="true" />
Layout XML
<com.akexorcist.roundcornerprogressbar.IconRoundCornerProgressBar
app:rcProgress="float"
app:rcSecondaryProgress="float"
app:rcMax="float"
app:rcRadius="dimension"
app:rcBackgroundPadding="dimension"
app:rcReverse="boolean"
app:rcProgressColor="color"
app:rcSecondaryProgressColor="color"
app:rcBackgroundColor="color"
app:rcAnimationEnable="boolean"
app:rcAnimationSpeedScale="float"
app:rcIconSrc="reference"
app:rcIconSize="dimension"
app:rcIconWidth="dimension"
app:rcIconHeight="dimension"
app:rcIconPadding="dimension"
app:rcIconPaddingLeft="dimension"
app:rcIconPaddingRight="dimension"
app:rcIconPaddingTop="dimension"
app:rcIconPaddingBottom="dimension"
app:rcIconBackgroundColor="color" />
Public Methods
// Progress
fun getMax(): Float
fun setMax(max: Float)
fun getProgress(): Float
fun setProgress(progress: Int)
fun setProgress(progress: Float)
fun getSecondaryProgress(): Float
fun setSecondaryProgress(secondaryProgress: Int)
fun setSecondaryProgress(secondaryProgress: Float)
// Dimension
fun getRadius(): Int
fun setRadius(radius: Int)
fun getPadding(): Int
fun setPadding(padding: Int)
fun getLayoutWidth(): Float
fun getIconSize(): Int
fun setIconSize(size: Int)
fun getIconPadding(): Int
fun setIconPadding(padding: Int)
fun getIconPaddingLeft(): Int
fun setIconPaddingLeft(padding: Int)
fun getIconPaddingTop(): Int
fun setIconPaddingTop(padding: Int)
fun getIconPaddingRight(): Int
fun setIconPaddingRight(padding: Int)
fun getIconPaddingBottom(): Int
fun setIconPaddingBottom(padding: Int)
// Animation
fun enableAnimation()
fun disableAnimation()
fun getAnimationSpeedScale(): Float
fun setAnimationSpeedScale(scale: Float)
fun isProgressAnimating(): Boolean
fun isSecondaryProgressAnimating(): Boolean
// Reversing Progress
fun isReverse(): Boolean
fun setReverse(isReverse: Boolean)
// Color
fun getProgressBackgroundColor(): Int
fun setProgressBackgroundColor(color: Int)
fun getProgressColor(): Int
fun setProgressColor(color: Int)
fun getProgressColors(): IntArray
fun setProgressColors(colors: IntArray)
fun getSecondaryProgressColor(): Int
fun setSecondaryProgressColor(color: Int)
fun getSecondaryProgressColors(): IntArray
fun setSecondaryProgressColors(colors: IntArray)
fun getColorIconBackground(): Int
fun setIconBackgroundColor(color: Int)
// Icon
fun getIconImageResource(): Int
fun setIconImageResource(resId: Int)
fun getIconImageBitmap(): Birmap
fun setIconImageBitmap(bitmap: Bitmap)
fun getIconImageDrawable(): Drawable
fun setIconImageDrawable(drawable: Drawable)
// Listener
fun setOnProgressChangedListener(listener: OnProgressChangedListener)
fun setOnIconClickListener(listener: OnIconClickListener)
TextRoundCornerProgressBar
Example
<com.akexorcist.roundcornerprogressbar.TextRoundCornerProgressBar
android:layout_width="260dp"
android:layout_height="30dp"
app:rcBackgroundColor="#0A000000"
app:rcBackgroundPadding="2dp"
app:rcMax="100"
app:rcProgress="40"
app:rcProgressColor="#EF5350"
app:rcRadius="80dp"
app:rcReverse="true"
app:rcSecondaryProgress="60"
app:rcSecondaryProgressColor="#40009688"
app:rcTextPositionPriority="outside"
app:rcTextProgress="40"
app:rcTextProgressColor="#111111" />
Layout XML
<com.akexorcist.roundcornerprogressbar.TextRoundCornerProgressBar
app:rcProgress="float"
app:rcSecondaryProgress="float"
app:rcMax="float"
app:rcRadius="dimension"
app:rcBackgroundPadding="dimension"
app:rcReverse="boolean"
app:rcProgressColor="color"
app:rcSecondaryProgressColor="color"
app:rcBackgroundColor="color"
app:rcAnimationEnable="boolean"
app:rcAnimationSpeedScale="float"
app:rcTextProgressColor="color"
app:rcTextProgressSize="dimension"
app:rcTextProgressMargin="dimension"
app:rcTextProgress="String"
app:rcTextInsideGravity="start|end"
app:rcTextOutsideGravity="start|end"
app:rcTextPositionPriority="inside|outside" />
Public Methods
// Progress
fun getMax(): Float
fun setMax(max: Float)
fun getProgress(): Float
fun setProgress(progress: Int)
fun setProgress(progress: Float)
fun getSecondaryProgress(): Float
fun setSecondaryProgress(secondaryProgress: Int)
fun setSecondaryProgress(secondaryProgress: Float)
// Dimension
fun getRadius(): Int
fun setRadius(radius: Int)
fun getPadding(): Int
fun setPadding(padding: Int)
fun getLayoutWidth(): Float
fun getTextProgressSize(): Int
fun setTextProgressSize(size: Int)
fun getTextProgressMargin(): Int
fun setTextProgressMargin(margin: Int)
// Animation
fun enableAnimation()
fun disableAnimation()
fun getAnimationSpeedScale(): Float
fun setAnimationSpeedScale(scale: Float)
fun isProgressAnimating(): Boolean
fun isSecondaryProgressAnimating(): Boolean
// Reversing Progress
fun isReverse(): Boolean
fun setReverse(isReverse: Boolean)
// Color
fun getProgressBackgroundColor(): Int
fun setProgressBackgroundColor(color: Int)
fun getProgressColor(): Int
fun setProgressColor(color: Int)
fun getProgressColors(): IntArray
fun setProgressColors(colors: IntArray)
fun getSecondaryProgressColor(): Int
fun setSecondaryProgressColor(color: Int)
fun getSecondaryProgressColors(): IntArray
fun setSecondaryProgressColors(colors: IntArray)
fun getTextProgressColor(): Int
fun setTextProgressColor(color: Int)
// Text
fun getProgressText(): String
fun setProgressText(text: String)
// Position
fun getTextPositionPriority(): Int
fun setTextPositionPriority(priority: Int)
fun getTextInsideGravity(): Int
fun setTextInsideGravity(gravity: Int)
fun getTextOutsideGravity(): Int
fun setTextOutsideGravity(gravity: Int)
// Listener
fun setOnProgressChangedListener(listener: OnProgressChangedListener)
IndeterminateRoundCornerProgressBar
Example
<com.akexorcist.roundcornerprogressbar.indeterminate.IndeterminateRoundCornerProgressBar
android:layout_width="260dp"
android:layout_height="10dp"
app:rcAnimationSpeedScale="3"
app:rcBackgroundColor="#0A000000"
app:rcProgressColor="#EF5350" />
Layout XML
<com.akexorcist.roundcornerprogressbar.indeterminate.IndeterminateRoundCornerProgressBar
app:rcRadius="dimension"
app:rcBackgroundPadding="dimension"
app:rcReverse="boolean"
app:rcProgressColor="color"
app:rcSecondaryProgressColor="color"
app:rcBackgroundColor="color"
app:rcAnimationSpeedScale="float" />
Public Methods
// Dimension
fun getRadius(): Int
fun setRadius(radius: Int)
fun getPadding(): Int
fun setPadding(padding: Int)
fun getLayoutWidth(): Float
// Animation
fun getAnimationSpeedScale(): Float
fun setAnimationSpeedScale(scale: Float)
// Reversing Progress
fun isReverse(): Boolean
fun setReverse(isReverse: Boolean)
// Color
fun getProgressBackgroundColor(): Int
fun setProgressBackgroundColor(color: Int)
fun getProgressColor(): Int
fun setProgressColor(color: Int)
fun getProgressColors(): IntArray
fun setProgressColors(colors: IntArray)
fun getSecondaryProgressColor(): Int
fun setSecondaryProgressColor(color: Int)
fun getSecondaryProgressColors(): IntArray
fun setSecondaryProgressColors(colors: IntArray)
IndeterminateCenteredRoundCornerProgressBar
Same as IndeterminateRoundCornerProgressBar
Example
<com.akexorcist.roundcornerprogressbar.indeterminate.IndeterminateCenteredRoundCornerProgressBar
android:layout_width="260dp"
android:layout_height="10dp"
app:rcAnimationSpeedScale="0.75"
app:rcBackgroundColor="#0A000000"
app:rcProgressColor="#EF5350" />
Layout XML
<com.akexorcist.roundcornerprogressbar.IndeterminateCenteredRoundCornerProgressBar
app:rcRadius="dimension"
app:rcBackgroundPadding="dimension"
app:rcReverse="boolean"
app:rcProgressColor="color"
app:rcSecondaryProgressColor="color"
app:rcBackgroundColor="color"
app:rcAnimationSpeedScale="float" />
Public Methods
// Dimension
fun getRadius(): Int
fun setRadius(radius: Int)
fun getPadding(): Int
fun setPadding(padding: Int)
fun getLayoutWidth(): Float
// Animation
fun getAnimationSpeedScale(): Float
fun setAnimationSpeedScale(scale: Float)
// Reversing Progress
fun isReverse(): Boolean
fun setReverse(isReverse: Boolean)
// Color
fun getProgressBackgroundColor(): Int
fun setProgressBackgroundColor(color: Int)
fun getProgressColor(): Int
fun setProgressColor(color: Int)
fun getProgressColors(): IntArray
fun setProgressColors(colors: IntArray)
fun getSecondaryProgressColor(): Int
fun setSecondaryProgressColor(color: Int)
fun getSecondaryProgressColors(): IntArray
fun setSecondaryProgressColors(colors: IntArray)
Apply Gradient Progress Bar Color
Gradient color for progress bar must be in int array resource. At least 2 colors.
<!-- Color Resource -->
<resources>
<array name="sample_progress_gradient">
<item>#009688</item>
<item>#80CBC4</item>
</array>
</resources>
<!-- Layout -->
<com.akexorcist.roundcornerprogressbar.RoundCornerProgressBar
...
app:rcBackgroundColor="#0A000000"
app:rcBackgroundPadding="4dp"
app:rcMax="100"
app:rcProgress="50"
app:rcProgressColors="@array/sample_progress_gradient"
app:rcRadius="30dp" />
Progress bar does not clipped when size changed. So the gradient color will fully display without clipping also.
Apply Progress Change Animation
Animation when progress change is disabled by default (exclude IndeterminateProgressBar
and IndeterminateCenteredProgressBar
).
So you have to enable the animation by XML attribute or programmatically
<com.akexorcist.roundcornerprogressbar.RoundCornerProgressBar
...
app:rcAnimationEnable="true"
app:rcAnimationSpeedScale="1" />
When progress changed, the animation will applied automatically.
Animation speed scale's value is float betweeen 0.2 - 5.0 (default is 1.0). Higher for slow down the animation, lower for speed up.
Related Articles
Thai Language : Round Corner Progress Bar สำหรับคนบ้าขอบมน
Special Thanks
@first087, @redsanso
What's Next
- IconTextRoundCornerProgressBar (#69)
- Support color resource in color related attributes
- Add set max progress with integer
- Set outside/inside text color in
TextRoundCornerProgressBar
separately
Known Issues
- Incorrect progress showing in
CenteredRoundCornerProgressBar
with 1%-2% value - Incorrect text's width in
TextRoundCornerProgressBar
whenoutside
priority and value close to 100% setProgress(progress: Int)
does not update text position
Licence
Copyright 2020 Akexorcist
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this work except in compliance with the License. You may obtain a copy of the License in the LICENSE file, or at:
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.