React

Quantity Picker

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

사용 가능 버전@seed-design/react@2.1.0, @seed-design/css@2.3.0

Installation

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

Props

Prop

Type

Examples

Layout

사용 가능 버전@seed-design/react@2.2.0, @seed-design/css@2.4.0

layout="hug"는 콘텐츠에 맞는 기존 너비를 유지합니다. 부모가 Flex 레이아웃이고 남은 공간을 채워야 한다면 layout="fill"을 사용하세요. 이때 양쪽 버튼 크기는 유지되고 Value Display 영역만 늘어납니다.

Value Text

getValueText를 사용하면 표시되는 수량에 단위나 보조 설명을 덧붙일 수 있습니다.

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

목차