# Blazor ChunkProgressBar Overview

The <a href = "https://www.telerik.com/blazor-ui/chunkprogressbar" target = "_blank">Blazor ChunkProgressBar component</a> tracks the execution of operations and displays what portion of it is completed in predefined number of sections (chunks). For very long tasks, you can also make it [indeterminate](https://www.telerik.com/blazor-ui/documentation/components/chunkprogressbar/indeterminate) while waiting for an update.

## Creating Blazor ChunkProgressBar

1. Add the `<TelerikChunkProgressBar>` tag.

2. Set its `Value` and `Max` parameters to denote the completed progress. Read more about the relationship between them in the [Chunk Count, Value and MaxValue](https://www.telerik.com/blazor-ui/documentation/components/chunkprogressbar/overview#chunk-count-value-and-maxvalue) section.

<demo metaUrl="client/chunkprogressbar/overview/basic/" height="200"></demo>

## Chunk Count, Value and MaxValue

This section explains the connection between the [ChunkCount, Value, and MaxValue parameters](https://www.telerik.com/blazor-ui/documentation/components/chunkprogressbar/overview#chunkprogressbar-parameters). In the [Matching Values](https://www.telerik.com/blazor-ui/documentation/components/chunkprogressbar/overview#matching-values) and the [Non-matching Values](https://www.telerik.com/blazor-ui/documentation/components/chunkprogressbar/overview#non-matching-values) sub-sections you can see how the ChunkProgressBar will render its chunks in these scenarios.

### Matching Values

When the `Max` and `ChunkCount` parameters match in value, the `Value` parameter represents the number of chunks that are highlighted.

<demo metaUrl="client/chunkprogressbar/overview/matching-values/" height="200"></demo>

### Non-matching Values

Each chunk (section) represents an equal part of the maximum value (`Max/ChunkCount`). So, when the `Max` and `ChunkCount` parameters do not match in value, the `Value` parameter highlights the number of chunks that is less than or equal (`<=`) to the full fractions that it represents.

In the example below each chunk is "worth" `10 / 4 = 2.5`. The `Value` is `3` so the full chunks this covers is `3 / 2.5 = 1.2`, so `1` chunk will be highlighted. If the `Value` is set to `4`, one chunk will remain highlighted, a second chunk will be highlighted when the `Value` becomes `5`.

<demo metaUrl="client/chunkprogressbar/overview/non-matching-values/" height="200"></demo>

## ChunkProgressBar Parameters

 <style>
    .article table {
        table-layout: auto;
        word-break: normal;
    }
</style>

| Parameter       | Type and Default Value                         | Description                                                                                                                                                                                                                                                                                                                                                                      |
| --------------- | ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Class`         | `string`                                       | Renders a custom CSS class to the `<div class="k-progressbar">` element.                                                                                                                                                                                                                                                                                                         |
| `Max`           | `double` <br /> (`100`)                        | The maximum value of the ChunkProgressBar. It must be greater than `0`.                                                                                                                                                                                                                                                                                                          |
| `Value`         | `double`                                       | The value of the ChunkProgressBar. This value indicates the progress of the tracked process and is distributed in the chunks (sections) of the ChunkProgressBar. It is a fraction of the `Max`. Read mode in the [Chunk Count, Value and MaxValue](https://www.telerik.com/blazor-ui/documentation/components/chunkprogressbar/overview#chunk-count-value-and-maxvalue) section. |
| `ChunkCount`    | `unsigned int` <br /> (`5`)                    | The number of chunks the ChunkProgressBar will be separated into.                                                                                                                                                                                                                                                                                                                |
| `Orientation`   | `ProgressBarOrientation` <br /> (`Horizontal`) | Controls the orientation of the Chunk Progress Bar.                                                                                                                                                                                                                                                                                                                              |
| `Indeterminate` | `bool` <br /> (`true`)                         | Controls if the Chunk Progress Bar is in indeterminate state. Read the [Indeterminate](https://www.telerik.com/blazor-ui/documentation/components/chunkprogressbar/indeterminate) article for more information.                                                                                                                                                                  |

## Examples

### Responsive ProgressBar

> caption The progress bar will resize with the parent element dimensions when you set its width to 100%

<demo metaUrl="client/chunkprogressbar/overview/responsive/" height="200"></demo>

## Next Steps

* [Learn more about the Indeterminate state](https://www.telerik.com/blazor-ui/documentation/components/chunkprogressbar/indeterminate)

## See Also

* [Live Demo: ChunkProgressBar](https://demos.telerik.com/blazor-ui/chunkprogressbar/overview)
* [ChunkProgressBar API Reference](https://www.telerik.com/blazor-ui/documentation/api/telerik.blazor.components.telerikchunkprogressbar)
