ProgressBar
in namespace DotVVM.Framework.Controls.Bootstrap4
Renders Bootstrap progress bar.
Usage & Scenarios
Renders Bootstrap Progress Bar widget.
Sample 1: Basic Progress Bar
The ProgressBar
control has the Value
property that sets value between 0 and 100.
Contextual color of ProgressBar
can be set with Color
property.
To show ProgressBar
custom text or label, place it inside the control. Default label is blank.
It is also possible to have hidden label in progress bar with HiddenTemplate
element. This content is wrapped in sr-only
CSS class to be read by screen readers.
<bs:ProgressBar Value="25">
25% completed...
</bs:ProgressBar>
<bs:ProgressBar Color="Info" Value="85">
<HiddenTemplate>
69% completed...
</HiddenTemplate>
</bs:ProgressBar>
Sample 2: Striped and Animated Progress Bars
You can set ProgressBar
to have various skins using the VisualStyle
property - the options are Solid
, Striped
or AnimatedStriped
.
<bs:ProgressBar Color="Danger" VisualStyle="Striped" Value="39">
39%
</bs:ProgressBar>
<bs:ProgressBar Color="Success" VisualStyle="AnimatedStriped" Value="100">
COMPLETED
</bs:ProgressBar>
Sample 3: Stacked Progress Bar
You can create Bootstrap stacked ProgressBars
using StackedProgressBar control.
<bs:StackedProgressBar>
<bs:ProgressBar Color="Success" Value="25">
25%
</bs:ProgressBar>
<bs:ProgressBar Color="Info" Value="25">
25%
</bs:ProgressBar>
<bs:ProgressBar Color="Warning" Value="11">
11%
</bs:ProgressBar>
<bs:ProgressBar Color="Danger" Value="14">
14%
</bs:ProgressBar>
</bs:StackedProgressBar>
Sample 4: ProgressBar - Bindings
The Value
and Color
properties of ProgressBar
are bindable.
<bs:ProgressBar Value="{value: Width}" Color="{value: Color}">
{{value: Width}}%
</bs:ProgressBar>
<dot:Button Text="Change width" Click="{command: ChangeWidth()}" />
<dot:Button Text="Change color" Click="{command: ChangeColor()}" />
public class ViewModel : DotvvmViewModelBase
{
public double Width { get; set; } = 95;
public BootstrapColor Color { get; set; } = BootstrapColor.Info;
public void ChangeWidth()
{
var random = new Random();
Width = random.Next(101);
}
public void ChangeColor()
{
var colors = Enum.GetValues(typeof(BootstrapColor)).Cast<BootstrapColor>().ToList();
var random = new Random();
var c = random.Next(colors.Count);
Color = colors[c];
}
}
Properties
Name | Type | Description | Notes | Default Value | |
---|---|---|---|---|---|
Attributes | Dictionary<String,Object> |
attribute
static value
|
null | ||
ClientIDMode | ClientIDMode | Gets or sets the client ID generation algorithm. |
attribute
static value
|
Static | |
Color | BootstrapColor | Gets or sets the contextual color of the control. |
attribute
static value
bindable
|
Primary | |
DataContext | Object | Gets or sets a data context for the control and its children. All value and command bindings are evaluated in context of this value. |
attribute
bindable
|
null | |
HiddenTemplate | ITemplate | Gets or sets additional hidden information of progress bar. |
inner element
static value
|
null | |
ID | String | Gets or sets the unique control ID. |
attribute
static value
bindable
|
null | |
IncludeInPage | Boolean | Gets or sets whether the control is included in the DOM of the page. |
attribute
bindable
|
True | |
InnerText | String | Gets or sets the inner text of the HTML element. |
attribute
static value
bindable
|
null | |
Value | Double | Gets or sets value of current progress. |
attribute
static value
bindable
|
100 | |
Visible | Boolean | Gets or sets whether the control is visible. |
attribute
bindable
|
True | |
VisualStyle | ProgressBarVisualStyle | Gets or sets whether the progress bar has solid fill, stripes or animated stripes. |
attribute
static value
bindable
|
Solid |