The component is used to display a linear progress bar. It can either display a progress bar that shows the user how much of a task has been completed. In the case where the percentage is not known it can be used to display an animated progress bar so the user can see that an operation is in progress.
There are two components for indicating progress:
VOnsProgressCircular. As the names imply, the
VOnsProgressBar displays a linear progress bar while the
VOnsProgressCircular displays a circular progress indicator.
They have the ability to show the current progress or a looping animation in cases where the current progress is not known.
Both components implement the same props.
To change the progress the
value property is used. It should be a value between
<v-ons-progress-bar :value="currentProgress"></v-ons-progress-bar> <v-ons-progress-circular :value="currentProgress" /></v-ons-progress-circular>
It is sometimes necessary to display two different values in the same progress indicator. An example could be an app that streams a video. The progress bar could show both how much of the video has elapsed in addition to how much of the video that has been buffered.
To do this the
secondaryValue property can be used.
<v-ons-progress-bar :value="elapsed" :secondaryValue="buffered" > </v-ons-progress-bar>
There is also an
indeterminate property which makes the component ignore both the
secondaryValue properties. Instead, it show a looping animation. This can be useful for cases where the total progress is unknown, e.g. when waiting for some data to arrive.
|indeterminate||Boolean||If this attribute is set, an infinite looping animation will be shown. Optional.|
|modifier||String||Change the appearance of the progress indicator. Optional.|
|secondary-value||Number||Current secondary progress. Should be a value between 0 and 100. Optional.|
|value||Number||Current progress. Should be a value between 0 and 100. Optional.|
|material||Display a Material Design progress bar.|
For bug reports and feature requests use our GitHub Issues page.