Design System

Component usage guide template

Browse Components

ui

Number Input

A formatted number input component with support for integer and decimal formats, automatic number formatting, and validation.

1. Import
Import the Number Input component from the design system.
import { NumberInput } from "@/design-system/components/ui/number-input"
2. Props
Number Input component props.
PropTypeDefault
labelstring | React.ReactNode--
format'integer' | 'decimal''integer'
maxnumber999999999999
allowNegativebooleanfalse
decimalMaxFractionDigitsnumber3
placeholderstring--
valuenumber--
onChange(e: React.ChangeEvent<HTMLInputElement>) => void--
wrapperClassNamestring--
inputClassNamestring--
rightOutsideReact.ReactNode--
errorstring--
3. Usages
Common Number Input patterns and configurations.
import { NumberInput } from "@/design-system/components/ui/number-input";
import { useState } from "react";

function Example() {
  const [value, setValue] = useState<number | undefined>(undefined);

  return (
    <NumberInput
      label="Amount"
      placeholder="Enter amount"
      value={value}
      onChange={(e) => setValue(e.target.value ? parseFloat(e.target.value) : undefined)}
    />
  );
}