# Input

Single-line field with internal or external labeling, hint, error, icons, and password reveal.

Use Input for one line of text. Compose an external Label with matching `for` and `id`, or provide at most one internal name through `label`, `aria-label`, or `aria-labelledby`.

## API

The package declarations define these public members.

### Inherited prop contracts

- `Omit<HTMLInputAttributes, 'value' | 'size' | 'aria-label' | 'aria-labelledby'>` — Props from this native base are accepted except the listed members.
- `Partial<AccessibleName>` — Optional internal naming accepts at most one of `label`, `aria-label`, or `aria-labelledby`; omit all three when an external `Label` targets the input `id`.

| Member | Type | Kind | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `aria-label` | `string` | prop | No | `undefined` | No additional description. |
| `aria-labelledby` | `string` | prop | No | `undefined` | No additional description. |
| `error` | `string` | prop | No | `undefined` | No additional description. |
| `hideLabel` | `string` | prop | No | `'Hide password'` | Accessible label for the reveal toggle while the password is shown. |
| `hint` | `string` | prop | No | `undefined` | No additional description. |
| `label` | `string` | prop | No | `undefined` | No additional description. |
| `leading` | `IconGlyph` | prop | No | `undefined` | Leading glyph component. |
| `leadingContent` | `Snippet` | snippet | No | `undefined` | Arbitrary leading content — a keycap, a prefix, a unit. Takes precedence over `leading`. A glyph and a snippet are both functions at runtime, so they cannot share one prop. |
| `revealToggle` | `boolean` | prop | No | `true` | Show a built-in show/hide toggle when `type="password"` and no custom `trailing`. |
| `showLabel` | `string` | prop | No | `'Show password'` | Accessible label for the reveal toggle while the password is hidden. |
| `trailing` | `IconGlyph` | prop | No | `undefined` | Trailing glyph component. Suppresses the built-in password reveal toggle. |
| `trailingContent` | `Snippet` | snippet | No | `undefined` | Arbitrary trailing content — a keycap, a character counter, a clear button. Takes precedence over `trailing` and suppresses the built-in password reveal toggle. |
| `value` | `string` | binding | No | `''` | No additional description. |

## Related

- [Label](/docs/components/label): Visible form label with required-state treatment.
- [Switch](/docs/components/switch): Bindable binary switch with visible or aria-only labeling.
- [Checkbox](/docs/components/checkbox): Bindable tri-state checkbox with a visible or ARIA-only accessible name.