콘텐츠로 이동
RefineUI

Spin Button

증분 변경용 숫자 스테퍼 입력.

Overview

Machine-readable contract from Component Spec.

component: spin-buttonexport: SpinButtonversion: 1attributes: data-refineui=spinbutton

Anatomy

Partdata-refineui
rootspinbutton
stepspinbutton-step

Variants

AxisValues
sizesm, md, lg

States

ScopeCategoryValues
componentpseudofocus-visible
componentenvironmentforced-colors, dir

Accessibility

SlotElementRole
spinbuttondivspinbutton

Focus

SectionPropertyValue
visualrequiredtrue
visualselector:focus-visible

Layout

PropertyValue
directionlogical
rtltrue
npm install @refineui/react @refineui/tokens
import { SpinButton } from "@refineui/react";
<SpinButton value={quantity} onChange={setQuantity} />
<SpinButton
value={amount}
onChange={setAmount}
min={0}
max={100}
step={5}
placeholder="Enter amount"
size="lg"
/>
PropDefaultTypeDescription
valuenumber제어형 값(필수).
onChange(value: number) => void값 변경 시 이벤트 핸들러(필수).
minnumber허용 최솟값.
maxnumber허용 최댓값.
step1number단계 증분.
placeholderstring플레이스홀더 텍스트.
size"md""sm" | "md" | "lg"컨트롤 높이 티어.
disabledfalseboolean인터랙션을 비활성화합니다.