﻿---
description: Компонент для визуализации прогресса выполнения задачи.
tags: loading
---

# Progress \[tag:component]

Компонент для визуализации прогресса выполнения задачи. Поддерживает различные стили оформления и настройку высоты.

```jsx
<Progress value={25} />
```

## Предустановленные цвета

```jsx
<FormItem id="progresslabel" top="Прогресс">
  <Progress aria-labelledby="progresslabel" value={40} />
</FormItem>
<FormItem id="progresslabelNegative" top="Ошибка">
  <Progress appearance="negative" aria-labelledby="progresslabelNegative" value={75} />
</FormItem>
<FormItem id="progresslabelPositive" top="Завершено">
  <Progress appearance="positive" aria-labelledby="progresslabelPositive" value={100} />
</FormItem>
```

## Пользовательские цвета

Используйте свойство `appearance` для задания произвольного цвета полоски прогресса. Поддерживаются:

### HEX-коды

```jsx
<Progress appearance="#FFA500" value={45} />
```

### CSS-переменные

```jsx
<div style={{ '--custom-progress': '#00FF00' }}>
  <Progress appearance="var(--custom-progress)" value={80} />
</div>
```

## Прозрачный фон

Для отключения фона можно использовать свойство `trackDisable`:

```jsx
<Progress appearance="#FFA500" trackDisable value={65} />
```

## Доступность (a11y) \[#a11y]

Доступность реализована на основе рекомендаций из [Meter WAI-ARIA design pattern](https://www.w3.org/WAI/ARIA/apg/patterns/meter/).

## Свойства и методы \[#api]

| Свойство       | Тип                                                                            | По умолчанию | Описание                        |
| -------------- | ------------------------------------------------------------------------------ | ------------ | ------------------------------- |
| `appearance`   | `"accent" \| "positive" \| "negative" \| `var(--$\{string})`\|`#$\{string}\`\` | `accent`     | Стиль отображения прогрессбара. |
| `getRootRef`   | `Ref<HTMLDivElement>`                                                          | `-`          |                                 |
| `height`       | `number`                                                                       | `-`          | Высота элемента.                |
| `ref`          | `Ref<HTMLDivElement>`                                                          | `-`          |                                 |
| `trackDisable` | `boolean`                                                                      | `false`      | Сделать прогрессбар прозрачным. |
| `value`        | `number`                                                                       | `0`          | Значение прогресса.             |
