스피너

스피너는 화면이나 요소의 다양한 처리 상태를 시각적으로 표시한 것으로 화면 전체나 일부 요소에 접근하기 위해 일정 시간 동안 대기해야 함을 사용자에게 안내한다.

사용 지침

결과 데이터가 도착하기 전 사용자 응답이 보류되는 짧은 비동기 구간에 표시하고, 작업이 1초 이상 지속될 가능성이 있다면 진행률 텍스트나 단계 표시기를 함께 고려합니다.

예제

기본

Loading data..
examples/spinner/SpinnerDefault.tsx
import { Spinner } from "@/components/ui/spinner"

export default function SpinnerDefault() {

라벨 없음

로딩 중
examples/spinner/SpinnerWithoutLabel.tsx
import { Spinner } from "@/components/ui/spinner"

export default function SpinnerWithoutLabel() {

폼 스피너 포함

로딩 중
examples/spinner/SpinnerWithFormSpinner.tsx
import { Spinner } from "@/components/ui/spinner"

export default function SpinnerWithFormSpinner() {

다중 스피너

Loading data..Processing...로딩 중
examples/spinner/SpinnerMultipleSpinners.tsx
import { Spinner } from "@/components/ui/spinner"

export default function SpinnerMultipleSpinners() {

속성

이름타입기본값설명
aria-labelstringDefines a string value that labels the current element. @see aria-labelledby.
classNamestring
idstring
labelstring로딩 중
onClickMouseEventHandler<HTMLSpanElement>
showLabelbooleanfalse
size"small" | "medium" | "large" | null
styleCSSProperties
tabIndexnumber
variantenumdefault