Skip to main content
The NumberField component provides a specialized input for numeric values with built-in increment/decrement controls and mouse scrubbing.

Installation

Usage

Components

NumberFieldRoot

number
Controlled value.
number
Default value.
function
Callback when value changes.
number
Minimum value.
number
Maximum value.
number
default:"1"
Step increment.
boolean
Disable the field.

NumberFieldInput

string
default:"md"
Size variant. Options: xs, sm, md, lg, xl
string
default:"default"
Visual variant.

NumberFieldIncrement

Button to increment the value.

NumberFieldDecrement

Button to decrement the value.

NumberFieldScrubArea

Interactive area for mouse scrubbing to change values.

NumberFieldScrubAreaCursor

Cursor icon shown during scrubbing.

Examples

Basic Number Field

With Range and Step

With Scrub Area

Controlled

Accessibility

  • Built on @base-ui/react for ARIA support
  • Keyboard navigation (Arrow Up/Down, Page Up/Down)
  • Screen reader announcements
  • Increment/decrement buttons are keyboard accessible
  • Proper min/max constraints