v0.3.0
Note: This documentation is in active development — content may be incomplete

Input

View as Markdown

Overview

Inputs are a form control that let users enter and edit single lines of text. Use them when users need to provide short, structured values such as email addresses.

<Field label="Email">
	<Input placeholder="email@example.com" />
</Field>

Usage Guidelines

  • Match the input to the value: Use the appropriate type for the value being collected, such as "email" or "password".
  • Use for short values: Use Input for concise, single-line values such as names, email addresses, or passwords. Move longer content to a more suitable control.
  • Use placeholders to provide context: Help users understand the expected shape of data to enter by using placeholders to show an example value or expected format.

API Reference

Input

PropTypeDefault
width"small" | "medium" | "large" | "fluid"-
type"text" | "email" | "password""text"
valuestring-
defaultValuestring-
placeholderstring-
disabledbooleanfalse

Examples

Basic field

Use Input inside Field to collect a short, labeled value with a clear example or hint.

<Field label="Email">
	<Input placeholder="email@example.com" />
</Field>

Icon

Use an icon to reinforce the input's purpose when the meaning is already clear from the surrounding context or placeholder.

<Input icon={<SearchIcon />} placeholder="Search by name" />

On this page

(Top)OverviewUsage GuidelinesAPI ReferenceInputExamplesBasic fieldIcon
v0.3.0

Overview

AboutGetting started

Components

AvatarBadgeBannerButtonCalloutCheckboxChipCodeCode InputColor InputData TableDialogDividerDisclosureDrawerEditable TextEmbedEmphasisError BoundaryFieldFile InputFlexFormFrameGridImageInlineInputMarqueeMenuPortalRootRadio GroupRich Text EditorSelectSkeletonSlotSortableSpacerSpinnerStackStatus IconStepperSwitchTab SwitchTextText AreaToggleUrlIcon