ProgressBarCircle
Круговой детерминированный индикатор. Занимает минимум места и хорошо читается в плотных интерфейсах — рядом с аватаром при upload, в ячейке таблицы, в карточке файла.
Демо
Prop
Type
Value
appearanceblue | green | neutral | orange | pink | primary | red | violet | yellow
classNametext
data-test-idtext
progressnumber
sizes | xs
Code
<ProgressBarCircle appearance="primary" size="s" progress={50} />Когда использовать
- Индикатор загрузки рядом с аватаром или миниатюрой.
- Прогресс в ячейках таблицы или в списке файлов.
- Там, где линейный индикатор слишком широкий.
Когда не нужен ProgressBarCircle: если есть горизонтальное место и вы хотите показать явный процент рядом — возьмите линейный ProgressBar.
Анатомия
Size
xs — дефолт, для ячеек таблиц и плотных списков; s — для карточек и более заметных мест.
Appearance
Семантика цвета заполненной дуги: primary — бренд/нейтральный; red — ошибка/превышение лимита; orange/yellow — предупреждение; green — успех; blue, violet, pink — декоративные категории.
Установка
pnpm add @cloud-ru/ds-progress-bar
import { ProgressBarCircle } from '@cloud-ru/ds-progress-bar'
Примеры использования
Значение 75%
tsx
import { ProgressBarCircle } from '@cloud-ru/ds-progress-bar';
export function CircleStatic() {
return <ProgressBarCircle progress={75} />;
}Три appearance
tsx
import { APPEARANCE, ProgressBarCircle } from '@cloud-ru/ds-progress-bar';
export function CircleAppearances() {
return (
<div style={{ display: 'flex', gap: 12, flexWrap: 'wrap', alignItems: 'center' }}>
<ProgressBarCircle progress={60} appearance={APPEARANCE.Primary} />
<ProgressBarCircle progress={60} appearance={APPEARANCE.Green} />
<ProgressBarCircle progress={60} appearance={APPEARANCE.Red} />
</div>
);
}Props
Types
Props
ProgressBarCircleProps| Prop | Type | Default | Required | Description |
|---|---|---|---|---|
appearance | "blue" | "green" | "neutral" | "orange" | "pink" | "primary" | "red" | "violet" | "yellow" | primary | no | Внешний вид |
className | string | — | no | CSS-класс |
data-test-id | string | — | no | |
progress | number | — | yes | Процент загрузки от 0 до 100 |
size | "s" | "xs" | s | no | Размер |