Input Text

A single-line text input for freeform string values. Supports label, description, validation states, dense mode (compact), and character limits.

Properties

Name	Type	Default	Description
`label`	`string`	`''`	Visible label text rendered above the input.
`description`	`string`	`''`	Helper text shown below the input. Hidden when message is non-empty.
`message`	`string`	`''`	State-coloured validation message shown below the input.
`state`	`'none' \| 'error' \| 'success'`	`'none'`	Validation state. Controls border colour and message colour.
`name`	`string`	`''`	HTML name attribute for form submission.
`value`	`string`	`''`	Controlled value (mutable). Reflects to the inner input.
`placeholder`	`string`	`''`	Placeholder text.
`disabled`	`boolean`	`false`	Disables all interaction.
`required`	`boolean`	`false`	Marks field as required. Adds visual asterisk and aria-required="true".
`readonly`	`boolean`	`false`	Allows focus and selection but not editing.
`hideLabel`	`boolean`	`false`	Visually hides the label while keeping it as the accessible name.
`compact`	`boolean`	`false`	Enables dense mode. Reduces input height from 44 px (default touch target) to 32 px.
`autoComplete`	`string`	`undefined`	HTML autocomplete attribute passed to the inner input.
`theme`	`'dark' \| 'light'`	`'dark'`	Per-component theme override. Reflects onto host data-theme.
`maxLength`	`number`	`undefined`	Maximum number of characters the user can enter.
`minLength`	`number`	`undefined`	Minimum number of characters required.
`spellCheck`	`boolean`	`undefined`	Whether the browser should spell-check the value.

Name	Detail type	Bubbles	Description
`change`	`string`	Yes	Emitted when the user commits a value (on blur or Enter).
`input`	`string`	Yes	Emitted on every keystroke / value change.
`blur`	`FocusEvent`	No	Emitted when the input loses focus.
`focus`	`FocusEvent`	No	Emitted when the input gains focus.