Progress

Progress

작업의 완료 진행률을 나타내는 인디케이터를 표시하는 컴포넌트로, 보통 진행바로 표시돼요.

출처: 문서

본문

작업의 진행 상태를 시각적 진행바와 보조 기술(스크린 리더) 양쪽으로 전달해 주는 컴포넌트예요. 보조 기술이 작업 진행률을 읽을 수 있는 맥락을 제공해요.

Features

  • 보조 기술이 작업 진행률을 읽을 수 있는 맥락 제공.

Anatomy

모든 파트를 임포트해 조립해요.

import { Progress } from "radix-ui";

export default () => (
  <Progress.Root>
    <Progress.Indicator />
  </Progress.Root>
);

Accessibility

progressbar role 요구사항을 준수해요.

API Reference

Root

모든 진행(progress) 파트를 담아요.

Prop Type Default
asChild boolean false
value number | null No default value
max number No default value
getValueLabel function No default value
Data attribute Values
[data-state] "complete" | "indeterminate" | "loading"
[data-value] The current value
[data-max] The max value

Indicator

진행률을 시각적으로 보여 주는 데 사용해요. 또한 진행률을 보조 기술에 접근 가능하게 만들어요.

Prop Type Default
asChild boolean false
Data attribute Values
[data-state] "complete" | "indeterminate" | "loading"
[data-value] The current value
[data-max] The max value

더 알아보기 (Learn more)

  • value에 null을 주면 indeterminate(불확정) 상태로 표시돼요.
  • getValueLabel prop으로 보조 기술에 읽힐 진행률 라벨을 커스터마이즈할 수 있어요.