For AI agents: the complete documentation index is available at https://wallarm.github.io/design-system/llms.txt, the full documentation bundle is available at https://wallarm.github.io/design-system/llms-full.txt, and this page is available as Markdown at https://wallarm.github.io/design-system/components/input.md.

Input

Short, single-line free text — reach for Textarea when the answer runs to sentences, and Select when it comes from a known set. Wrap it in Field for the label and description; a placeholder is an example of the answer, never a substitute for the label and never where required information lives.

Source · Storybook

Usage

import { Input } from '@wallarm-org/design-system/Input';

Examples

Sizes

A 36 / 32 / 24px scale shared with Textarea, InputGroup and the date inputs, so a row of mixed fields lines up. Reach below default only in dense places like a table filter.

Focused

Focus is a ring outside the border rather than a border change, so nothing reflows by a pixel when the reader tabs through a form.

Disabled

Dimmed and not focusable. Say elsewhere what would enable it — a disabled field with no explanation reads as broken.

With value

A filled field. Placeholder text is deliberately set at the same size as real input so the text doesn't jump when typing starts; only its colour is lighter.

With error

error reddens the border and sets aria-invalid. It shows that something is wrong but not what — the message is FieldError's job.

Props

PropTypeDefaultDescription
titlestring | undefined
patternstring | undefined
defaultCheckedboolean | undefined
defaultValuestring | number | readonly string[] | undefined
autoFocusboolean | undefined
idstring | undefined
tabIndexnumber | undefined
relstring | undefined
onChangeChangeEventHandler<T, HTMLInputElement> | undefined
typeHTMLInputTypeAttribute | undefined
disabledboolean | undefinedfalse
namestring | undefined
valuestring | number | readonly string[] | undefined
altstring | undefined
heightstring | number | undefined
srcstring | undefined
widthstring | number | undefined
autoCompleteHTMLInputAutoCompleteAttribute | undefined
maxLengthnumber | undefined
minLengthnumber | undefined
placeholderstring | undefined
readOnlyboolean | undefined
requiredboolean | undefined
checkedboolean | undefined
stepstring | number | undefined
acceptstring | undefined
maxstring | number | undefined
minstring | number | undefined
multipleboolean | undefined
size{ default: string; medium: string; small: string; 'inline-edit': string; }default
error{ true: string; false: string; }false
data-testidstring | undefined