Playground

Number input

A numeric field with decrease and increase buttons.

  • Built on native elements
  • Native input type="number"; ArrowUp/ArrowDown change the value.
  • The step buttons are named "Decrease" and "Increase" and are skipped by Tab.
  • Styles in one file: 03-form-fields.css

Import

import '@monoline/css';
import {NumberInput} from '@monoline/react';

Not installed yet? Pick a route.

Copies the source and its styles into your project.

npx monoline add number-input

Usage

import {Field, NumberInput} from '@monoline/react';

<div style={{maxWidth: '200px'}}>
  <Field label="Quantity">
    <NumberInput defaultValue={1} min={0} max={10} />
  </Field>
</div>

Examples

Quantity

Props

NumberInputProps

PropTypeDefaultDescription
size"sm" | "md" | "lg"'md'`md` (default), `sm` for dense layouts or `lg` for prominent forms. Heights match Button, Input and Select at each size.
invalidboolean–Marks the control invalid (`aria-invalid`). A surrounding Field sets this from its `error`.

Data Attributes

State is exposed through attributes. Style it with these selectors, not with class toggles.

AttributeStylesheet
[aria-checked="true"]03-form-fields.css
[aria-invalid="true"]03-form-fields.css
[aria-pressed="true"]03-form-fields.css

CSS classes

ClassStylesheet
.field03-form-fields.css
.field-hint03-form-fields.css
.input03-form-fields.css
.input-bare03-form-fields.css
.input-end03-form-fields.css
.input-lg03-form-fields.css
.input-sm03-form-fields.css
.input-wrap03-form-fields.css
.muted03-form-fields.css
.seg03-form-fields.css
.seg-opt03-form-fields.css
.select03-form-fields.css
.setting03-form-fields.css
.switch03-form-fields.css
.textarea03-form-fields.css
.number-fieldnumber-input.css
.number-inputnumber-input.css
.number-stepnumber-input.css

Customization

Style it with the kit's tokens in your own CSS, loaded after @monoline/css. Prefer the attributes above over extra classes. See Theming for every token.

app.css
.field {
  border-color: var(--accent);
}
.field[aria-checked="true"] {
  background: var(--wash);
}

Accessibility

  • Native input type="number"; ArrowUp/ArrowDown change the value.
  • The step buttons are named "Decrease" and "Increase" and are skipped by Tab.

Keyboard

KeysAction
ArrowUp / ArrowDownChange the value