React

Quantity Picker

정수 단위의 수량을 늘리거나 줄일 때 사용하는 컴포넌트입니다.

Installation

npx @seed-design/cli@latest add ui:quantity-picker

Props

Prop

Type

decrementAriaLabel?string | undefined
incrementAriaLabel?string | undefined
decrementIcon?React.ReactNode
incrementIcon?React.ReactNode
removeIcon?React.ReactNode
loadingIndicator?React.ReactNode
inputProps?SeedQuantityPicker.HiddenInputProps | undefined
defaultValue?number | undefined
value?number | undefined
onValueChange?((value: number) => void) | undefined
minnumber
maxnumber
loading?QuantityPickerLoading | undefined
onRemove?(() => void) | undefined
getValueText?QuantityPickerGetValueText | undefined
removeAriaLabel?string | undefined

Examples

Controlled

valueonValueChange를 사용해 수량 상태를 외부에서 제어할 수 있습니다.

Removable

removable을 사용하면 값이 min에 도달했을 때 Decrement 버튼이 Remove 버튼으로 전환됩니다. onRemove에서 제거 동작을 처리하세요.

Loading

loading으로 모든 action 또는 특정 action의 실행을 일시적으로 막고 loading indicator를 표시할 수 있습니다.

Form

inputPropsname을 전달하면 현재 수량이 hidden input으로 제출됩니다.

Accessibility

Root에는 Quantity Picker의 용도를 설명하는 aria-label 또는 aria-labelledby를 제공하세요. 필요하면 decrementAriaLabel, incrementAriaLabel, removeAriaLabel로 각 action의 접근성 이름을 맥락에 맞게 변경할 수 있습니다.

getValueText를 사용하면 ValueDisplay의 숫자를 사람이 읽기 쉬운 텍스트로 제공할 수 있습니다. 이 값은 hidden input에 제출되는 raw integer 값에 영향을 주지 않습니다.

Last updated on

On this page