Number Field
A numeric input with step buttons, bounds, locale formatting and optional drag-to-scrub.
Paste this into your agent.
Number Field holds numbers people adjust: quantities, seats, timeouts, budgets. It keeps the value numeric while showing it formatted, and clamps it to your range.
Install
bashnpx shadcn@4.18.0 add @siteplane/number-field
Import it from @/siteplane/components/number-field. The project needs Siteplane UI's one-time setup first: .
When to pick it
- vs : Pick Slider when an approximate position on a range matters more than an exact number.
- vs : Pick Input for digit strings that are not quantities, like phone numbers or postcodes.
- vs : Pick OTP Field for a fixed-length verification code.
Rules
- Compose
NumberFieldGroupwithNumberFieldDecrement,NumberFieldInputandNumberFieldIncrement, and addNumberFieldScrubAreawith alabelfor scrubbing. - Use
nullfor an empty value, and constrain edits withmin,maxandstep. - Pass
formatandlocalefor currency or percent; the stored value stays a plain number. - Put the
nameon the surrounding Field so Form submits the number, and addclassName="w-full"when it should fill a column. - Keep the label above the control. Number Field has no floating label.
Reference
Add to your agent
Print this skill from the terminal, or connect the whole catalog over MCP. Setup guides
CLI
MCP server
Questions
Related skills
Form Field Validation Timingby UI Skillbook
Validate at the right moment — not on every keystroke, not only on submit.
Forms
Siteplane Attachmentby UI Skillbook
A card for a file or image attached to a message or draft, with upload states and actions.
Siteplane UI
Siteplane Autocompleteby UI Skillbook
A text input that suggests completions while still accepting whatever the person types.
Siteplane UI
Siteplane Calendarby UI Skillbook
An inline month grid for picking a single date, several dates or a range, with unavailable-day rules.
Siteplane UI