Circular progress view android

A fancy CircularProgressView.

CircularProgressView is distributed through Maven Central, Jcenter and Jitpack.

Check out the sample module where you can find a few examples of how to create it by xml or java .

Attributes accepted in xml:

You can take advantage of Binding Adapters (from Data Binding) to create some helper attributes, example:

Progress with gradient

For the given array of colors:

The default result will be (left):

To achieve the result on the right side you have two options: either copy the first color and add it as last, or use the helper attribute/method that does that for you:

Finally, you may also use the attribute progressBarColorArrayPositions to pass a float[] positions :

note: when using the helper function and positions[] , you’ll have to add an extra position for the last one being copied.

There are many methods to help you customize this View by code. For more details checkout the sample app, javadocs or the code itself.

«Multiple Progress» for PieChart

This mode can be used to display a simple pie chart. It will disable the progress thumb, the background color and the progress will not be round.

Animation last update on April, 2019

Bugs and Feedback

For bugs, questions and discussions please use the Github Issues.

Licensed under the Apache License, Version 2.0 (the «License»); you may not use this file except in compliance with the License. You may obtain a copy of the License at

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.

Источник

Circular Progress Bar Android Tutorial [4 Easy Steps]

Welcome to Circular progress bar android Tutorial. In android development Progress bar is widely used and in many forms but one that is arguably the most loved is “Circular Progress bar with text”.

If you have been in android development for even a couple of months you have at-least once wondered how can I get a progress bar with text progress well you are in luck cause we are going to do just that in this tutorial as shown in picture and possibly a little more.

Circular progress bar with text in android is pretty easy to make and takes like 4 easy steps to do just that but before we dive right in let’s take a look at what it actually is.

What is a Progress bar?

An UI element that signifies that a process is executing and shows progress as its name would suggest. Progress bar in general supports two modes to represent progress.

Determinate (By Default Linear)
Indeterminate (By Default Circular)

Indeterminate Progress Bar

One example of this can be the very default Progress Bar we have now the circular motion with an animation we can consider using these kinds of Progress Bar when an operation under execution and we wouldn’t know how long that would take.

A great and most familiar example of this can be an api endpoint call we would not know what can happen until we get a response. Using an indeterminate Progress Bar here makes sense because of the uncertainty.

Determinate Progress Bar

These are progress bar that are for task that are somewhat known to us for example can be how long it will take to download a file from the server. These are recommended to use in applications where these tasks are for the users to see along with the progress.

A default Determinate Progress Bar is a linear line which can be set Progress on dynamically and can be hardcoded too (but that wouldn’t make much sense)

Note: While the default types of these are circular and linear it doesn’t mean a Determinate ProgressBar cannot be circular and vice-versa

What exactly are we going to build?

To answer that we can refer to this picture

and also this optionally

this can be called as a circular determinant progress bar with progress on it shown with help of a TextView centered in between

We could also go ahead and create a custom view to do this but for making this tutorial a bit more easier we are going to use another approach.

Prerequisites

Android Studio
Basic Knowledge of Android Views
Kotlin Basic Knowledge

we can use both an activity or a fragment here. So let’s start with the steps right away !

Creating the View

Here we have used an activity to create this view which has a constraint view as its parent

Источник

Circular progress view android

Usual CircularProgressBar but with cool dash effect in background stroke and fade animation.

A demo app is available on Google Play

Add this to your project build.gradle

Add this to your module build.gradle

Background stroke with Dash Effect

Licensed under the Apache License, Version 2.0 (the «License»); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Источник

Circular progress view android

This CircularProgressView is a (surprisingly) circular progress bar Android View that is designed to imitate the Material versions of ProgressBar. These versions can be seen on this page of the Material design spec under Circular indicators.

To use CircularProgressView you must add it as a dependency in your Gradle build:

Then add the view to your layout:

That’s all you need! If you don’t want the CircularProgressView to automatically start animating, omit the app:cpv_animAutostart option and start it manually yourself:

Name	Type	Default	Description
cpv_progress	float	0	The current progress of the progress bar.
cpv_maxProgress	float	100	The maximum progress of the progress bar; what’s considered as 100% of the bar.
cpv_thickness	dimension	4px	The thickness of the progress bar.
cpv_color	color	Theme’s accent color. If not available, Material Blue 500 (#2196F3)	The color of the progress bar.
cpv_indeterminate	boolean	false	Whether this progress bar is indeterminate or not. If indeterminate, the progress set on this view will not have any effect.
cpv_animDuration	integer	4000	The duration of the indeterminate progress bar animation in milliseconds. It is the duration of all «steps» of the indeterminate animation. (Indeterminate only)
cpv_animSwoopDuration	integer	5000	The duration of the initial swoop of the determinate animation. (Determinate only)
cpv_animSyncDuration	integer	500	The duration of the determinate progress update animation. When you use setUpdate(int) , this is how long it takes for the view to finish animating to that progress. (Determinate only)
cpv_animSteps	integer	3	The number of «steps» in the indeterminate animation (how many times it does the loopy thing before returning to its original position). It is recommended to use an odd number, as even numbers of steps look the same after half the number of steps.
cpv_animAutostart	boolean	false	Whether this progress bar should automatically start animating once it is initialized.
cpv_startAngle	float	0	The starting angle for progress bar. (Determinate only)

Name	Description
isIndeterminate()	Returns true if the progress bar is indeterminate, false if determinate.
setIndeterminate(boolean)	Set whether this progress bar is indeterminate or not. Will reset the animation if the value changes
getThickness()	Gets the thickness of the progress bar.
setThickness(int)	Sets thickness of the progress bar.
getColor()	Gets the color of the progress bar.
setColor(int)	Sets the color of the progress bar.
getMaxProgress()	Gets the maximum progress of the progress bar.
setMaxProgress(float)	Sets the maximum progress of the progress bar.
getProgress()	Gets the current progress of the progress bar.
setProgress(float)	Sets the current progress of the progress bar. (Will linearly animate the update.)
startAnimation()	Starts the animation of the progress bar. (Alias of resetAnimation().)
resetAnimation()	Resets the animation of the progress bar.
stopAnimation()	Stops the animation of the progress bar.
addListener(CircularProgressViewListener)	Registers a CircularProgressViewListener with this view.
removeListener(CircularProgressViewListener)	Unregisters a CircularProgressViewListener with this view.

A CircularProgressViewListener class is available for listening to some events (as well as a CircularProgressViewAdapter ).

Event	Description
onProgressUpdate(float)	Called when setProgress is called. (Determinate only)
onProgressUpdateEnd(float)	Called when this view finishes animating to the updated progress. (Determinate only)
onAnimationReset()	Called when resetAnimation() is called.
onModeChange(boolean)	Called when you switch between indeterminate and determinate modes.

CircularProgressView flickers when phone is in battery saving mode

This happens because battery saving mode automatically ends all Animators, but the ones in CPV run in an endless loop. The best way to work around this right now is to use the native ProgressBar for API >21, since that is when the battery saver mode was introduced. See this issue comment on how to accomplish this.

Источник

Circular progress view android

An Android circular progress view

Latest commit

Git stats

Files

Failed to load latest commit information.

README.md

A custom progress view/button for Android. It combines button and progress view. You can custom button image resource by XML.

All these tag is optional. You needn’t keep ratio of width and height. It use the min value of width and height as the circular progress’s diameter.

You should not to use CircularProgressView.setOnClickListener() , but use CircularProgressView.setOnStateListener() instead.

Call CircularProgressView.reset() to reset this view to origin state or call CircularProgressView.resetSmoothly() to reset with animation.

This view doesn’t support indeterminate mode, you must call CircularProgressView.setProgress(int progress) to update progress, or call CircularProgressView.setDuration(long millis) to set progress duration.

By default, once it’s clicked it will start animation from beginDrawable to progressDrawable. If you want to start animation manually, you can set app:cpv_startAnimationAuto=»false» in xml or call setStartAnimationAuto(boolean) in java code.And then you can call startAnimation() at any time you want.

And you can also set app:cpv_clickAnimationDelayMillis=»100″ or call setClickedAnimationDelay(int) to set start animation delay time.

Источник