컴포넌트
Number Input
숫자 입력. ↑↓·± 버튼, 범위 고정, 천 단위 쉼표.
시간
원
import { useState } from 'react'
import { Field } from '@zest/primitives/Field.js'
import { NumberInput } from '@zest/primitives/NumberInput.js'
export default function Demo() {
const [h, setH] = useState<number | undefined>(8)
const [pay, setPay] = useState<number | undefined>(3200000)
return (
<div className="flex w-full max-w-[300px] flex-col gap-4">
<Field label="근무 시간"><NumberInput value={h} onValueChange={setH} min={0} max={12} step={0.5} unit="시간" /></Field>
<Field label="월 급여"><NumberInput value={pay} onValueChange={setPay} min={0} step={10000} unit="원" /></Field>
</div>
)
}설치
shadcn CLI 로 소스를 프로젝트에 가져와요. 테마·유틸·의존 부품이 함께 설치돼요.
npx shadcn@latest add @zest/number-input패키지로 쓰려면 @zest-im/ui 에서 가져와요. 설치 안내
사용법
import { NumberInput } from '@/components/ui/number-input'위 미리보기의 「코드」 탭이 실제로 동작하는 예제예요.
API
| prop | 타입 | 설명 |
|---|---|---|
value? | number | — |
onValueChange | (value?: number | undefined) => void | — |
min? | number | — |
max? | number | — |
step? | number | — |
unit? | string | 「시간」「원」 같은 단위 |
disabled? | boolean | — |
id? | string | — |
className? | string | — |
aria-describedby? | string | — |
aria-invalid? | boolean | — |
aria-label? | string | — |
표에 없는 HTML·Radix 속성은 그대로 전달돼요.
접근성
role="spinbutton" 과 aria-valuenow/min/max.