reopt design
DocsExploreTemplatesCanvasToolsPricing
Login
opt-uiopt-chartsopt-datagridopt-editoropt-calendaropt-filemanageropt-chatopt-shellbrandapp-ui
Overview205Core74Shells99Blocks32
Progress
reopt designreopt design

A design system for the AI era

  • Docs
  • Pricing
  • Releases
  • About
  • Contact
  • Terms of Service
  • Privacy Policy

reopt Inc.Business registration no. 217-88-02453contact@reopt.ai

© 2026 reopt Inc. All rights reserved.

Progress

Component

Show linear or circular progress in determinate and indeterminate modes with normalized ARIA values.

indicator
Related docs
bun add @reopt-ai/opt-ui
Install and import
bash
bun add @reopt-ai/opt-ui
tsx
import { Progress, CircularProgress } from "@reopt-ai/opt-ui";

Live preview

Change the width and theme, then interact with the components.

100%

Linear Progress

With Label

다운로드 중30%
업로드 중65%
완료100%

Variants

60%
60%
60%
60%

Circular Progress

50%
75%

Circular Variants

70%
70%
70%
70%

값을 알 수 없는 진행 상태

데이터 동기화 중
분석 준비 중

value를 생략하거나 indeterminate를 지정하면 값 관련 ARIA 속성 없이 진행 중 상태만 안내합니다.

Animation Demo

파일 업로드0%
0%

Usage guidance

Best practices

  • When progress is measurable, provide value and max in the same units. Give the progress indicator an accessible name describing the task.

Usage to avoid

  • Do not invent numeric progress for an unmeasurable task. Remove the in-progress state when the task completes or fails.

Usage examples

Upload progress

Progress

PropTypeDefaultDescription
valuenumber—현재 값. 생략하면 indeterminate 상태
maxnumber100최대 값
size"sm" | "md" | "lg""md"진행바 높이
variant"default" | "success" | "warning" | "error""default"색상 변형
showLabelbooleanfalse퍼센트 표시
labelstring—레이블 텍스트
animatedbooleantrue애니메이션 활성화
indeterminatebooleanfalse값을 알 수 없는 진행 상태

CircularProgress

PropTypeDefaultDescription
valuenumber—현재 값. 생략하면 indeterminate 상태
maxnumber100최대 값
sizenumber48원 크기 (px)
strokeWidthnumber4선 두께
variant"default" | "success" | "warning" | "error""default"색상 변형
showLabelbooleanfalse중앙에 퍼센트 표시
labelstring—접근성 레이블
indeterminatebooleanfalse값을 알 수 없는 진행 상태

컴포넌트 의존 관계

깊이
▲ USED BY (2)project-settingsuser-detailProgress
View test results

테스트 커버리지

2026년 7월 9일8/8 통과
8성공
0실패
8전체
  • progressbar role을 렌더링한다
  • aria 속성을 설정한다
  • label을 표시한다
  • 범위를 벗어난 값을 aria와 표시값 모두에서 클램프한다
  • max가 0이어도 NaN 퍼센트를 노출하지 않는다
  • 비정상 숫자 입력을 접근성 값에 노출하지 않는다
  • variant에 따른 스타일을 적용한다
  • value를 생략하면 indeterminate progressbar로 렌더링한다

Blocks that use this component

opt-ui

ProjectSettings

Blocks

Manage project settings, retention policies, cleanup previews, and storage usage with forms, tables, and code snippets.

opt-ui

UserDetail

Blocks

Build user profiles with avatars, metrics, gauges, progress indicators, tables, and filters.

Related components

opt-ui

Kbd

Core

Display keyboard shortcuts as inline key badges.

opt-ui

StatCard

Core

Show a metric with its value, change, and supporting description. Omit the change row when no comparison is available.

opt-ui

CompositeZone

Core

Navigate child elements in two dimensions with arrow keys using a Composite container.

opt-ui

Toolbar

Core

Group actions in a toolbar with buttons, separators, and tooltips.

opt-ui

Badge

Core

Display inline status badges with five color variants and an optional status dot.

opt-ui

Spinner

Core

Indicate loading in three sizes, with an aria-hidden mode for decorative use.

PreviousAvatarNextMeter