# Input

A labelled text field with a hint, an error, a size, and an optional glyph.

## Web 0.2.0

### Usage

Choose the input type for the value and connect changes to form state. Pair the control with Field for instructions and errors.

### Accessibility

Associate a visible label with the input. Describe errors in text and preserve the native input keyboard behavior.

### When to use

Use for a short typed value. Use Textarea for paragraphs and NumberField for numeric stepping.

### Install

Add this registry to your project's components.json once, before the first install. Keep your existing settings and other registries.

```json
{
  "registries": {
    "@maeso": "http://127.0.0.1:4321/r/{name}.json"
  }
}
```

Then install the registry's default theme once, and import its sheet in the CSS entry that imports Tailwind. It paints every item from this registry.

```sh
npx shadcn@latest add @maeso/maeso
```

```css
@import "./styles/theme.web.css";
```

```sh
npx shadcn@latest add @maeso/input
```

### Props

#### Input

| Prop | Type | Required | Description |
| --- | --- | --- | --- |
| error | ReactNode | no |  |
| fieldStyle | CSSProperties \| undefined | no | Reaches the field box itself, for a control sitting on a raised surface. |
| hint | ReactNode | no |  |
| iconLeft | "activity" \| "adjustments-horizontal" \| "alert-triangle" \| "app-window" \| "arrow-down" \| "arrow-left" \| "arrow-right" \| "arrow-up" \| "arrow-up-right" \| "arrows-diagonal" \| "arrows-diagonal-minimize-2" \| "at" \| "award" \| "bell" \| "calendar" \| "check" \| "chevron-down" \| "chevron-left" \| "chevron-right" \| "chevron-up" \| "circle" \| "circle-check" \| "circle-dashed" \| "circle-dot" \| "circle-help" \| "circle-pause" \| "circle-play" \| "circle-slash" \| "click" \| "clipboard-check" \| "clock" \| "compass" \| "copy" \| "corner-down-right" \| "corner-up-left" \| "cpu" \| "device-mobile" \| "device-tablet" \| "dots" \| "download" \| "eraser" \| "external-link" \| "eye" \| "file" \| "file-pen" \| "file-plus" \| "file-text" \| "folder" \| "git-branch" \| "globe" \| "grip-vertical" \| "history" \| "inbox" \| "info" \| "info-circle" \| "keyboard" \| "layout-grid" \| "link" \| "list" \| "list-checks" \| "lock" \| "log-out" \| "marquee-2" \| "message-2" \| "message-square" \| "minus" \| "monitor" \| "moon" \| "note" \| "octagon-x" \| "panel-left-close" \| "panel-left-open" \| "paperclip" \| "pencil" \| "play" \| "plug" \| "plus" \| "pointer" \| "refresh-cw" \| "rotate-cw" \| "route" \| "scale" \| "search" \| "settings" \| "shield-check" \| "slash" \| "square" \| "square-half" \| "sun" \| "terminal-2" \| "trash" \| "triangle-alert" \| "unplug" \| "upload" \| "user" \| "user-round" \| "user-round-check" \| "users" \| "wallet" \| "workflow" \| "wrap-text" \| "x" \| undefined | no |  |
| label | ReactNode | no |  |
| mono | boolean \| undefined | no | A machine-owned value — a reference, a path, a hex — takes the mono cut. |
| ref | Ref<HTMLInputElement> \| undefined | no | The input itself, for a caller that has to move focus or read its value. |
| size | ControlSize \| undefined | no |  |
| style | CSSProperties \| undefined | no | Reaches the wrapper, which carries the label and the message too. |
| suffix | string \| undefined | no |  |
| trailing | ReactNode | no | A control that belongs to the field, such as a reveal or a clear action. |

##### Inherited

Also accepts every `<input>` attribute, 306 props

| Prop | Type | Required | Description |
| --- | --- | --- | --- |
| about | string \| undefined | no |  |
| accept | string \| undefined | no |  |
| accessKey | string \| undefined | no |  |
| alt | string \| undefined | no |  |
| aria-activedescendant | string \| undefined | no | Identifies the currently active element when DOM focus is on a composite widget, textbox, group, or application. |
| aria-atomic | Booleanish \| undefined | no | Indicates whether assistive technologies will present all, or only parts of, the changed region based on the change notifications defined by the aria-relevant attribute. |
| aria-autocomplete | "both" \| "inline" \| "list" \| "none" \| undefined | no | Indicates whether inputting text could trigger display of one or more predictions of the user's intended value for an input and specifies how predictions would be<br>presented if they are made. |
| aria-braillelabel | string \| undefined | no | Defines a string value that labels the current element, which is intended to be converted into Braille. |
| aria-brailleroledescription | string \| undefined | no | Defines a human-readable, author-localized abbreviated description for the role of an element, which is intended to be converted into Braille. |
| aria-busy | Booleanish \| undefined | no |  |
| aria-checked | "false" \| "mixed" \| "true" \| boolean \| undefined | no | Indicates the current "checked" state of checkboxes, radio buttons, and other widgets. |
| aria-colcount | number \| undefined | no | Defines the total number of columns in a table, grid, or treegrid. |
| aria-colindex | number \| undefined | no | Defines an element's column index or position with respect to the total number of columns within a table, grid, or treegrid. |
| aria-colindextext | string \| undefined | no | Defines a human readable text alternative of aria-colindex. |
| aria-colspan | number \| undefined | no | Defines the number of columns spanned by a cell or gridcell within a table, grid, or treegrid. |
| aria-controls | string \| undefined | no | Identifies the element (or elements) whose contents or presence are controlled by the current element. |
| aria-current | "date" \| "false" \| "location" \| "page" \| "step" \| "time" \| "true" \| boolean \| undefined | no | Indicates the element that represents the current item within a container or set of related elements. |
| aria-describedby | string \| undefined | no | Identifies the element (or elements) that describes the object. |
| aria-description | string \| undefined | no | Defines a string value that describes or annotates the current element. |
| aria-details | string \| undefined | no | Identifies the element that provides a detailed, extended description for the object. |
| aria-disabled | Booleanish \| undefined | no | Indicates that the element is perceivable but disabled, so it is not editable or otherwise operable. |
| aria-dropeffect | "copy" \| "execute" \| "link" \| "move" \| "none" \| "popup" \| undefined | no | Indicates what functions can be performed when a dragged object is released on the drop target. |
| aria-errormessage | string \| undefined | no | Identifies the element that provides an error message for the object. |
| aria-expanded | Booleanish \| undefined | no | Indicates whether the element, or another grouping element it controls, is currently expanded or collapsed. |
| aria-flowto | string \| undefined | no | Identifies the next element (or elements) in an alternate reading order of content which, at the user's discretion,<br>allows assistive technology to override the general default of reading in document source order. |
| aria-grabbed | Booleanish \| undefined | no | Indicates an element's "grabbed" state in a drag-and-drop operation. |
| aria-haspopup | "dialog" \| "false" \| "grid" \| "listbox" \| "menu" \| "tree" \| "true" \| boolean \| undefined | no | Indicates the availability and type of interactive popup element, such as menu or dialog, that can be triggered by an element. |
| aria-hidden | Booleanish \| undefined | no | Indicates whether the element is exposed to an accessibility API. |
| aria-invalid | "false" \| "grammar" \| "spelling" \| "true" \| boolean \| undefined | no | Indicates the entered value does not conform to the format expected by the application. |
| aria-keyshortcuts | string \| undefined | no | Indicates keyboard shortcuts that an author has implemented to activate or give focus to an element. |
| aria-label | string \| undefined | no | Defines a string value that labels the current element. |
| aria-labelledby | string \| undefined | no | Identifies the element (or elements) that labels the current element. |
| aria-level | number \| undefined | no | Defines the hierarchical level of an element within a structure. |
| aria-live | "assertive" \| "off" \| "polite" \| undefined | no | Indicates that an element will be updated, and describes the types of updates the user agents, assistive technologies, and user can expect from the live region. |
| aria-modal | Booleanish \| undefined | no | Indicates whether an element is modal when displayed. |
| aria-multiline | Booleanish \| undefined | no | Indicates whether a text box accepts multiple lines of input or only a single line. |
| aria-multiselectable | Booleanish \| undefined | no | Indicates that the user may select more than one item from the current selectable descendants. |
| aria-orientation | "horizontal" \| "vertical" \| undefined | no | Indicates whether the element's orientation is horizontal, vertical, or unknown/ambiguous. |
| aria-owns | string \| undefined | no | Identifies an element (or elements) in order to define a visual, functional, or contextual parent/child relationship<br>between DOM elements where the DOM hierarchy cannot be used to represent the relationship. |
| aria-placeholder | string \| undefined | no | Defines a short hint (a word or short phrase) intended to aid the user with data entry when the control has no value.<br>A hint could be a sample value or a brief description of the expected format. |
| aria-posinset | number \| undefined | no | Defines an element's number or position in the current set of listitems or treeitems. Not required if all elements in the set are present in the DOM. |
| aria-pressed | "false" \| "mixed" \| "true" \| boolean \| undefined | no | Indicates the current "pressed" state of toggle buttons. |
| aria-readonly | Booleanish \| undefined | no | Indicates that the element is not editable, but is otherwise operable. |
| aria-relevant | "additions" \| "additions removals" \| "additions text" \| "all" \| "removals" \| "removals additions" \| "removals text" \| "text" \| "text additions" \| "text removals" \| undefined | no | Indicates what notifications the user agent will trigger when the accessibility tree within a live region is modified. |
| aria-required | Booleanish \| undefined | no | Indicates that user input is required on the element before a form may be submitted. |
| aria-roledescription | string \| undefined | no | Defines a human-readable, author-localized description for the role of an element. |
| aria-rowcount | number \| undefined | no | Defines the total number of rows in a table, grid, or treegrid. |
| aria-rowindex | number \| undefined | no | Defines an element's row index or position with respect to the total number of rows within a table, grid, or treegrid. |
| aria-rowindextext | string \| undefined | no | Defines a human readable text alternative of aria-rowindex. |
| aria-rowspan | number \| undefined | no | Defines the number of rows spanned by a cell or gridcell within a table, grid, or treegrid. |
| aria-selected | Booleanish \| undefined | no | Indicates the current "selected" state of various widgets. |
| aria-setsize | number \| undefined | no | Defines the number of items in the current set of listitems or treeitems. Not required if all elements in the set are present in the DOM. |
| aria-sort | "ascending" \| "descending" \| "none" \| "other" \| undefined | no | Indicates if items in a table or grid are sorted in ascending or descending order. |
| aria-valuemax | number \| undefined | no | Defines the maximum allowed value for a range widget. |
| aria-valuemin | number \| undefined | no | Defines the minimum allowed value for a range widget. |
| aria-valuenow | number \| undefined | no | Defines the current value for a range widget. |
| aria-valuetext | string \| undefined | no | Defines the human readable text alternative of aria-valuenow for a range widget. |
| autoCapitalize | "characters" \| "none" \| "off" \| "on" \| "sentences" \| "words" \| (string & {}) \| undefined | no |  |
| autoComplete | HTMLInputAutoCompleteAttribute \| undefined | no |  |
| autoCorrect | string \| undefined | no |  |
| autoFocus | boolean \| undefined | no |  |
| autoSave | string \| undefined | no |  |
| capture | "environment" \| "user" \| boolean \| undefined | no |  |
| checked | boolean \| undefined | no |  |
| children | ReactNode | no |  |
| className | string \| undefined | no |  |
| color | string \| undefined | no |  |
| content | string \| undefined | no |  |
| contentEditable | "inherit" \| "plaintext-only" \| Booleanish \| undefined | no |  |
| contextMenu | string \| undefined | no |  |
| dangerouslySetInnerHTML | { __html: string \| TrustedHTML; } \| undefined | no |  |
| datatype | string \| undefined | no |  |
| defaultChecked | boolean \| undefined | no |  |
| defaultValue | string \| number \| readonly string[] \| undefined | no |  |
| dir | string \| undefined | no |  |
| disabled | boolean \| undefined | no |  |
| draggable | Booleanish \| undefined | no |  |
| enterKeyHint | "done" \| "enter" \| "go" \| "next" \| "previous" \| "search" \| "send" \| undefined | no |  |
| exportparts | string \| undefined | no |  |
| form | string \| undefined | no |  |
| formAction | string \| ((formData: FormData) => void \| Promise<void>) \| undefined | no |  |
| formEncType | string \| undefined | no |  |
| formMethod | string \| undefined | no |  |
| formNoValidate | boolean \| undefined | no |  |
| formTarget | string \| undefined | no |  |
| height | string \| number \| undefined | no |  |
| hidden | boolean \| undefined | no |  |
| id | string \| undefined | no |  |
| inert | boolean \| undefined | no |  |
| inlist | any | no |  |
| inputMode | "decimal" \| "email" \| "none" \| "numeric" \| "search" \| "tel" \| "text" \| "url" \| undefined | no | Hints at the type of data that might be entered by the user while editing the element or its contents |
| is | string \| undefined | no | Specify that a standard HTML element should behave like a defined custom built-in element |
| itemID | string \| undefined | no |  |
| itemProp | string \| undefined | no |  |
| itemRef | string \| undefined | no |  |
| itemScope | boolean \| undefined | no |  |
| itemType | string \| undefined | no |  |
| lang | string \| undefined | no |  |
| list | string \| undefined | no |  |
| max | string \| number \| undefined | no |  |
| maxLength | number \| undefined | no |  |
| min | string \| number \| undefined | no |  |
| minLength | number \| undefined | no |  |
| multiple | boolean \| undefined | no |  |
| name | string \| undefined | no |  |
| nonce | string \| undefined | no |  |
| onAbort | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onAbortCapture | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onAnimationEnd | AnimationEventHandler<HTMLInputElement> \| undefined | no |  |
| onAnimationEndCapture | AnimationEventHandler<HTMLInputElement> \| undefined | no |  |
| onAnimationIteration | AnimationEventHandler<HTMLInputElement> \| undefined | no |  |
| onAnimationIterationCapture | AnimationEventHandler<HTMLInputElement> \| undefined | no |  |
| onAnimationStart | AnimationEventHandler<HTMLInputElement> \| undefined | no |  |
| onAnimationStartCapture | AnimationEventHandler<HTMLInputElement> \| undefined | no |  |
| onAuxClick | MouseEventHandler<HTMLInputElement> \| undefined | no |  |
| onAuxClickCapture | MouseEventHandler<HTMLInputElement> \| undefined | no |  |
| onBeforeInput | InputEventHandler<HTMLInputElement> \| undefined | no |  |
| onBeforeInputCapture | InputEventHandler<HTMLInputElement> \| undefined | no |  |
| onBeforeToggle | ToggleEventHandler<HTMLInputElement> \| undefined | no |  |
| onBlur | FocusEventHandler<HTMLInputElement> \| undefined | no |  |
| onBlurCapture | FocusEventHandler<HTMLInputElement> \| undefined | no |  |
| onCanPlay | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onCanPlayCapture | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onCanPlayThrough | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onCanPlayThroughCapture | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onChange | ChangeEventHandler<HTMLInputElement, HTMLInputElement> \| undefined | no |  |
| onChangeCapture | ChangeEventHandler<HTMLInputElement, Element> \| undefined | no |  |
| onClick | MouseEventHandler<HTMLInputElement> \| undefined | no |  |
| onClickCapture | MouseEventHandler<HTMLInputElement> \| undefined | no |  |
| onCompositionEnd | CompositionEventHandler<HTMLInputElement> \| undefined | no |  |
| onCompositionEndCapture | CompositionEventHandler<HTMLInputElement> \| undefined | no |  |
| onCompositionStart | CompositionEventHandler<HTMLInputElement> \| undefined | no |  |
| onCompositionStartCapture | CompositionEventHandler<HTMLInputElement> \| undefined | no |  |
| onCompositionUpdate | CompositionEventHandler<HTMLInputElement> \| undefined | no |  |
| onCompositionUpdateCapture | CompositionEventHandler<HTMLInputElement> \| undefined | no |  |
| onContextMenu | MouseEventHandler<HTMLInputElement> \| undefined | no |  |
| onContextMenuCapture | MouseEventHandler<HTMLInputElement> \| undefined | no |  |
| onCopy | ClipboardEventHandler<HTMLInputElement> \| undefined | no |  |
| onCopyCapture | ClipboardEventHandler<HTMLInputElement> \| undefined | no |  |
| onCut | ClipboardEventHandler<HTMLInputElement> \| undefined | no |  |
| onCutCapture | ClipboardEventHandler<HTMLInputElement> \| undefined | no |  |
| onDoubleClick | MouseEventHandler<HTMLInputElement> \| undefined | no |  |
| onDoubleClickCapture | MouseEventHandler<HTMLInputElement> \| undefined | no |  |
| onDrag | DragEventHandler<HTMLInputElement> \| undefined | no |  |
| onDragCapture | DragEventHandler<HTMLInputElement> \| undefined | no |  |
| onDragEnd | DragEventHandler<HTMLInputElement> \| undefined | no |  |
| onDragEndCapture | DragEventHandler<HTMLInputElement> \| undefined | no |  |
| onDragEnter | DragEventHandler<HTMLInputElement> \| undefined | no |  |
| onDragEnterCapture | DragEventHandler<HTMLInputElement> \| undefined | no |  |
| onDragExit | DragEventHandler<HTMLInputElement> \| undefined | no |  |
| onDragExitCapture | DragEventHandler<HTMLInputElement> \| undefined | no |  |
| onDragLeave | DragEventHandler<HTMLInputElement> \| undefined | no |  |
| onDragLeaveCapture | DragEventHandler<HTMLInputElement> \| undefined | no |  |
| onDragOver | DragEventHandler<HTMLInputElement> \| undefined | no |  |
| onDragOverCapture | DragEventHandler<HTMLInputElement> \| undefined | no |  |
| onDragStart | DragEventHandler<HTMLInputElement> \| undefined | no |  |
| onDragStartCapture | DragEventHandler<HTMLInputElement> \| undefined | no |  |
| onDrop | DragEventHandler<HTMLInputElement> \| undefined | no |  |
| onDropCapture | DragEventHandler<HTMLInputElement> \| undefined | no |  |
| onDurationChange | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onDurationChangeCapture | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onEmptied | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onEmptiedCapture | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onEncrypted | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onEncryptedCapture | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onEnded | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onEndedCapture | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onError | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onErrorCapture | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onFocus | FocusEventHandler<HTMLInputElement> \| undefined | no |  |
| onFocusCapture | FocusEventHandler<HTMLInputElement> \| undefined | no |  |
| onGotPointerCapture | PointerEventHandler<HTMLInputElement> \| undefined | no |  |
| onGotPointerCaptureCapture | PointerEventHandler<HTMLInputElement> \| undefined | no |  |
| onInput | InputEventHandler<HTMLInputElement> \| undefined | no |  |
| onInputCapture | InputEventHandler<HTMLInputElement> \| undefined | no |  |
| onInvalid | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onInvalidCapture | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onKeyDown | KeyboardEventHandler<HTMLInputElement> \| undefined | no |  |
| onKeyDownCapture | KeyboardEventHandler<HTMLInputElement> \| undefined | no |  |
| onKeyPress | KeyboardEventHandler<HTMLInputElement> \| undefined | no |  |
| onKeyPressCapture | KeyboardEventHandler<HTMLInputElement> \| undefined | no |  |
| onKeyUp | KeyboardEventHandler<HTMLInputElement> \| undefined | no |  |
| onKeyUpCapture | KeyboardEventHandler<HTMLInputElement> \| undefined | no |  |
| onLoad | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onLoadCapture | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onLoadedData | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onLoadedDataCapture | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onLoadedMetadata | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onLoadedMetadataCapture | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onLoadStart | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onLoadStartCapture | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onLostPointerCapture | PointerEventHandler<HTMLInputElement> \| undefined | no |  |
| onLostPointerCaptureCapture | PointerEventHandler<HTMLInputElement> \| undefined | no |  |
| onMouseDown | MouseEventHandler<HTMLInputElement> \| undefined | no |  |
| onMouseDownCapture | MouseEventHandler<HTMLInputElement> \| undefined | no |  |
| onMouseEnter | MouseEventHandler<HTMLInputElement> \| undefined | no |  |
| onMouseLeave | MouseEventHandler<HTMLInputElement> \| undefined | no |  |
| onMouseMove | MouseEventHandler<HTMLInputElement> \| undefined | no |  |
| onMouseMoveCapture | MouseEventHandler<HTMLInputElement> \| undefined | no |  |
| onMouseOut | MouseEventHandler<HTMLInputElement> \| undefined | no |  |
| onMouseOutCapture | MouseEventHandler<HTMLInputElement> \| undefined | no |  |
| onMouseOver | MouseEventHandler<HTMLInputElement> \| undefined | no |  |
| onMouseOverCapture | MouseEventHandler<HTMLInputElement> \| undefined | no |  |
| onMouseUp | MouseEventHandler<HTMLInputElement> \| undefined | no |  |
| onMouseUpCapture | MouseEventHandler<HTMLInputElement> \| undefined | no |  |
| onPaste | ClipboardEventHandler<HTMLInputElement> \| undefined | no |  |
| onPasteCapture | ClipboardEventHandler<HTMLInputElement> \| undefined | no |  |
| onPause | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onPauseCapture | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onPlay | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onPlayCapture | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onPlaying | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onPlayingCapture | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onPointerCancel | PointerEventHandler<HTMLInputElement> \| undefined | no |  |
| onPointerCancelCapture | PointerEventHandler<HTMLInputElement> \| undefined | no |  |
| onPointerDown | PointerEventHandler<HTMLInputElement> \| undefined | no |  |
| onPointerDownCapture | PointerEventHandler<HTMLInputElement> \| undefined | no |  |
| onPointerEnter | PointerEventHandler<HTMLInputElement> \| undefined | no |  |
| onPointerLeave | PointerEventHandler<HTMLInputElement> \| undefined | no |  |
| onPointerMove | PointerEventHandler<HTMLInputElement> \| undefined | no |  |
| onPointerMoveCapture | PointerEventHandler<HTMLInputElement> \| undefined | no |  |
| onPointerOut | PointerEventHandler<HTMLInputElement> \| undefined | no |  |
| onPointerOutCapture | PointerEventHandler<HTMLInputElement> \| undefined | no |  |
| onPointerOver | PointerEventHandler<HTMLInputElement> \| undefined | no |  |
| onPointerOverCapture | PointerEventHandler<HTMLInputElement> \| undefined | no |  |
| onPointerUp | PointerEventHandler<HTMLInputElement> \| undefined | no |  |
| onPointerUpCapture | PointerEventHandler<HTMLInputElement> \| undefined | no |  |
| onProgress | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onProgressCapture | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onRateChange | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onRateChangeCapture | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onReset | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onResetCapture | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onScroll | UIEventHandler<HTMLInputElement> \| undefined | no |  |
| onScrollCapture | UIEventHandler<HTMLInputElement> \| undefined | no |  |
| onScrollEnd | UIEventHandler<HTMLInputElement> \| undefined | no |  |
| onScrollEndCapture | UIEventHandler<HTMLInputElement> \| undefined | no |  |
| onSeeked | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onSeekedCapture | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onSeeking | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onSeekingCapture | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onSelect | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onSelectCapture | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onStalled | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onStalledCapture | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onSubmit | SubmitEventHandler<HTMLInputElement> \| undefined | no |  |
| onSubmitCapture | SubmitEventHandler<HTMLInputElement> \| undefined | no |  |
| onSuspend | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onSuspendCapture | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onTimeUpdate | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onTimeUpdateCapture | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onToggle | ToggleEventHandler<HTMLInputElement> \| undefined | no |  |
| onTouchCancel | TouchEventHandler<HTMLInputElement> \| undefined | no |  |
| onTouchCancelCapture | TouchEventHandler<HTMLInputElement> \| undefined | no |  |
| onTouchEnd | TouchEventHandler<HTMLInputElement> \| undefined | no |  |
| onTouchEndCapture | TouchEventHandler<HTMLInputElement> \| undefined | no |  |
| onTouchMove | TouchEventHandler<HTMLInputElement> \| undefined | no |  |
| onTouchMoveCapture | TouchEventHandler<HTMLInputElement> \| undefined | no |  |
| onTouchStart | TouchEventHandler<HTMLInputElement> \| undefined | no |  |
| onTouchStartCapture | TouchEventHandler<HTMLInputElement> \| undefined | no |  |
| onTransitionCancel | TransitionEventHandler<HTMLInputElement> \| undefined | no |  |
| onTransitionCancelCapture | TransitionEventHandler<HTMLInputElement> \| undefined | no |  |
| onTransitionEnd | TransitionEventHandler<HTMLInputElement> \| undefined | no |  |
| onTransitionEndCapture | TransitionEventHandler<HTMLInputElement> \| undefined | no |  |
| onTransitionRun | TransitionEventHandler<HTMLInputElement> \| undefined | no |  |
| onTransitionRunCapture | TransitionEventHandler<HTMLInputElement> \| undefined | no |  |
| onTransitionStart | TransitionEventHandler<HTMLInputElement> \| undefined | no |  |
| onTransitionStartCapture | TransitionEventHandler<HTMLInputElement> \| undefined | no |  |
| onVolumeChange | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onVolumeChangeCapture | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onWaiting | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onWaitingCapture | ReactEventHandler<HTMLInputElement> \| undefined | no |  |
| onWheel | WheelEventHandler<HTMLInputElement> \| undefined | no |  |
| onWheelCapture | WheelEventHandler<HTMLInputElement> \| undefined | no |  |
| part | string \| undefined | no |  |
| pattern | string \| undefined | no |  |
| placeholder | string \| undefined | no |  |
| popover | "" \| "auto" \| "hint" \| "manual" \| undefined | no |  |
| popoverTarget | string \| undefined | no |  |
| popoverTargetAction | "hide" \| "show" \| "toggle" \| undefined | no |  |
| prefix | string \| undefined | no |  |
| property | string \| undefined | no |  |
| radioGroup | string \| undefined | no |  |
| readOnly | boolean \| undefined | no |  |
| rel | string \| undefined | no |  |
| required | boolean \| undefined | no |  |
| resource | string \| undefined | no |  |
| results | number \| undefined | no |  |
| rev | string \| undefined | no |  |
| role | AriaRole \| undefined | no |  |
| security | string \| undefined | no |  |
| slot | string \| undefined | no |  |
| spellCheck | Booleanish \| undefined | no |  |
| src | string \| undefined | no |  |
| step | string \| number \| undefined | no |  |
| suppressContentEditableWarning | boolean \| undefined | no |  |
| suppressHydrationWarning | boolean \| undefined | no |  |
| tabIndex | number \| undefined | no |  |
| title | string \| undefined | no |  |
| translate | "no" \| "yes" \| undefined | no |  |
| type | HTMLInputTypeAttribute \| undefined | no |  |
| typeof | string \| undefined | no |  |
| unselectable | "off" \| "on" \| undefined | no |  |
| value | string \| number \| readonly string[] \| undefined | no |  |
| vocab | string \| undefined | no |  |
| width | string \| number \| undefined | no |  |

### Proof

#### Contrast

measured on 0.2.0

| State | Foreground | Background | Ratio | Floor |
| --- | --- | --- | --- | --- |
| default | rgb(67 77 86) | rgb(248 245 240) | 7.93 | AA 4.5 |
| default (dark) | rgb(181 182 182) | rgb(7 21 34) | 9.07 | AA 4.5 |

#### Keyboard

measured on 0.2.0

| Key | Action |
| --- | --- |
| abc | Type text into the field |
| Backspace | Delete the character before the caret |
| ControlOrMeta+A | Select all text for replacement |
| Shift+Tab | Move focus to the previous control |
| Tab | Move focus back into the field |

#### Size

19167 gzip bytes · measured on 0.2.0

### Example

```tsx
import { Input } from "@/components/ui/_kit/forms/input/Input";

const Example = () => (
		<Input label="Work email" placeholder="you@company.com" hint="We reply in one day." />
	);
export default Example;
```

### Preview · 0.2.0

not on native yet
