# Progress **Also known as:** ProgressIndicator, ProgressBar, Spinner ## Description BitProgress is used to show the completion status of an operation. ## Parameters | Name | Type | Default Value | Description | | :--- | :--- | :------------ | :---------- | | AriaValueText | `string?` | null | Text alternative of the progress status, used by screen readers for reading the value of the progress. | | Classes | `BitProgressClassStyles?` | null | Custom CSS classes for different parts of the BitProgress. | | Color | `BitColor?` | null | The general color of the BitProgress. | | Circular | `bool` | false | Circular mode of the BitProgress. | | Description | `string?` | null | Text describing or supplementing the operation. | | DescriptionTemplate | `RenderFragment?` | null | Custom template for describing or supplementing the operation. | | Indeterminate | `bool` | false | Whether or not to show indeterminate progress animation. | | Label | `string?` | null | Label to display above the BitProgress. | | LabelTemplate | `RenderFragment?` | null | Custom label template to display above the BitProgress. | | Percent | `double` | 0 | Percentage of the operation's completeness, numerically between 0 and 100. | | PercentNumberFormat | `string` | {0:F0} % | The format of the percent number in percentage display. | | Radius | `int` | 6 | The radius of the circular progress. | | ShowPercentNumber | `bool` | false | Whether or not to percentage display. | | Size | `BitSize?` | null | The size of the BitProgress. | | Styles | `BitProgressClassStyles?` | null | Custom CSS Styles for different parts of the BitProgress. | | Thickness | `int?` | null | Thickness of the BitProgress. When not set, the value is determined by the Size parameter. | | AriaLabel | `string?` | null | Gets or sets the accessible label for the component, used by assistive technologies. | | Class | `string?` | null | Gets or sets the CSS class name(s) to apply to the rendered element. | | Dir | `BitDir?` | null | Gets or sets the text directionality for the component's content. | | ForceAnimation | `bool` | false | Gets or sets a value indicating whether the component's animations play at their full duration even when reduced motion is requested. | | HtmlAttributes | `Dictionary<string, object>` | new Dictionary<string, object>() | Captures additional HTML attributes to be applied to the rendered element, in addition to the component's parameters. | | Id | `string?` | null | Gets or sets the unique identifier for the component's root element. | | IsEnabled | `bool` | true | Gets or sets a value indicating whether the component is enabled and can respond to user interaction. | | Style | `string?` | null | Gets or sets the CSS style string to apply to the rendered element. | | TabIndex | `string?` | null | Gets or sets the tab order index for the component when navigating with the keyboard. | | Visibility | `BitVisibility` | BitVisibility.Visible | Gets or sets the visibility state (visible, hidden, or collapsed) of the component. | ## Public Members | Name | Type | Default Value | Description | | :--- | :--- | :------------ | :---------- | | UniqueId | `Guid` | Guid.NewGuid() | Gets the readonly unique identifier for the component's root element, assigned when the component instance is constructed. | | RootElement | `ElementReference` | | Gets the reference to the root HTML element associated with this component. | ## Enums ### BitColor Enum | Name | Value | Description | | :--- | :--- | :---------- | | Primary | 0 | Primary general color. | | Secondary | 1 | Secondary general color. | | Tertiary | 2 | Tertiary general color. | | Info | 3 | Info general color. | | Success | 4 | Success general color. | | Warning | 5 | Warning general color. | | SevereWarning | 6 | SevereWarning general color. | | Error | 7 | Error general color. | | PrimaryBackground | 8 | Primary background color. | | SecondaryBackground | 9 | Secondary background color. | | TertiaryBackground | 10 | Tertiary background color. | | PrimaryForeground | 11 | Primary foreground color. | | SecondaryForeground | 12 | Secondary foreground color. | | TertiaryForeground | 13 | Tertiary foreground color. | | PrimaryBorder | 14 | Primary border color. | | SecondaryBorder | 15 | Secondary border color. | | TertiaryBorder | 16 | Tertiary border color. | ### BitSize Enum | Name | Value | Description | | :--- | :--- | :---------- | | Small | 0 | The small size. | | Medium | 1 | The medium size. | | Large | 2 | The large size. | ### BitVisibility Enum | Name | Value | Description | | :--- | :--- | :---------- | | Visible | 0 | The content of the component is visible. | | Hidden | 1 | The content of the component is hidden, but the space it takes on the page remains (visibility:hidden). | | Collapsed | 2 | The component is hidden (display:none). | ### BitDir Enum | Name | Value | Description | | :--- | :--- | :---------- | | Ltr | 0 | Ltr (left to right) is to be used for languages that are written from the left to the right (like English). | | Rtl | 1 | Rtl (right to left) is to be used for languages that are written from the right to the left (like Arabic). | | Auto | 2 | Auto lets the user agent decide. It uses a basic algorithm as it parses the characters inside the element until it finds a character with a strong directionality, then applies that directionality to the whole element. | ## Sub Classes ### BitProgressClassStyles Properties | Name | Type | Default Value | Description | | :--- | :--- | :------------ | :---------- | | Root | `string?` | null | Custom CSS classes/styles for the root element of the BitProgress. | | Label | `string?` | null | Custom CSS classes/styles for the label of the BitProgress. | | PercentNumber | `string?` | null | Custom CSS classes/styles for the percent number of the BitProgress. | | BarContainer | `string?` | null | Custom CSS classes/styles for the bar container of the BitProgress. | | Track | `string?` | null | Custom CSS classes/styles for the track of the BitProgress. | | Bar | `string?` | null | Custom CSS classes/styles for the bar of the BitProgress. | | Description | `string?` | null | Custom CSS classes/styles for the description of the BitProgress. | ## Examples \n**Basic**: ```razor ``` \n**Circular**: ```razor ``` \n**ShowPercentNumber**: ```razor ``` \n**Thickness**: ```razor ``` ```csharp private double barThickness = 10; ``` \n**Indeterminate**: ```razor ``` \n**Color**: ```razor ``` \n**Size**: ```razor ``` \n**Spinner**: ```razor ``` \n**Style & Class**: ```razor ``` \n**RTL**: ```razor ```