Input

A labelled text field built on React Aria - leading and trailing adornments, hint text, and required/invalid states with a cross-fading focus ring.

This is a hint about this input.

Installation

You can add this input component using our CLI or manually:

Dark mode ready - this component follows BoardUI semantic tokens automatically. Set up theme switching.

The CLI copies the component source (with its internal dependencies) into your project and installs any required npm packages.

npx boardui@latest add input

Using a shared UI package or custom import aliases? Configure your installation paths before running the CLI. Copy-paste examples use the default imports.

Sizes

This is a hint about this input.
This is a hint about this input.

States

This is a hint about this input.
This is a hint about this input.
This is a hint about this input.
This is a hint about this input.

Error message

errorMessage replaces the hint while the field is invalid, in React Aria's error slot, so the input is described by it. With isRequired alone, React Aria validates natively on submit: it blocks the form, marks the field invalid and moves focus to it, and keeps the browser's own bubble from showing, so the message is what people see. With validationBehavior="aria", nothing blocks the submit, and the field is invalid only when you pass isInvalid or validate returns an error.

Shown on your profile.

Phone number

This is a hint about this input.
This is a hint about this input.