reopt design
DocsExploreTemplatesCanvasToolsPricing
Login
opt-uiopt-chartsopt-datagridopt-editoropt-calendaropt-filemanageropt-chatopt-shellbrandapp-ui
Overview205Core74Shells99Blocks32
Input
reopt designreopt design

A design system for the AI era

  • Docs
  • Pricing
  • Releases
  • About
  • Contact
  • Terms of Service
  • Privacy Policy

reopt Inc.Business registration no. 217-88-02453contact@reopt.ai

© 2026 reopt Inc. All rights reserved.

Input

Component

Use a standalone text input with labels, errors, hints, and icons.

input
Related docs
bun add @reopt-ai/opt-ui
Install and import
bash
bun add @reopt-ai/opt-ui
tsx
import { Input } from "@reopt-ai/opt-ui";

Live preview

Change the width and theme, then interact with the components.

100%

Basic

With Hint

8자 이상 입력하세요

영문, 숫자만 사용 가능

Error State

이미 사용 중인 이름입니다

올바른 이메일 형식이 아닙니다

With Icons

원

Usage guidance

Best practices

  • Use label to explain the input's purpose and hint for its format. error is an error message string and takes precedence over hint when shown.
  • Keep controlled values as strings and store event.target.value from onChange. Avoid duplicate labels when composing with FormControl.

Usage to avoid

  • Do not use placeholder as the only label or switch between controlled and uncontrolled state while rendering.

Usage examples

Basic usage
FormStore integration

Input

PropTypeDefaultDescription
labelstring—입력 필드 레이블
errorstring—에러 메시지. 표시 시 aria-invalid=true 설정
hintstring—힌트 텍스트 (에러 없을 때만 표시)
leftIconReactNode—입력 필드 왼쪽에 표시할 아이콘
rightIconReactNode—입력 필드 오른쪽에 표시할 아이콘
fullWidthbooleanfalse전체 너비 사용 여부

컴포넌트 의존 관계

깊이
▲ USED BY (14)filter-barproperty-exploreralert-builderevent-meta-editorreport-buildersegment-builderprompt-templatewebhook-configsaved-filterschat-sidebarquery-variables-menusave-query-dialogmarketplace-catalogworkflow-run-historyInput
View test results

테스트 커버리지

2026년 7월 9일11/11 통과
11성공
0실패
11전체
  • textbox role을 렌더링한다
  • label을 렌더링하고 연결한다
  • error 메시지를 표시한다
  • hint 텍스트를 표시한다
  • 타이핑이 가능하다
  • required prop이 RequiredMark를 표시한다
  • aria-required를 설정한다
  • aria-describedby가 hint에 연결된다
  • label 없이 aria-label만 있어도 hint를 aria-describedby로 연결한다
  • size=sm 스타일을 적용한다
  • size=lg 스타일을 적용한다

Blocks that use this component

opt-ui

MarketplaceCatalog

Blocks

Browse a marketplace card grid with search, tab filters, and sorting.

opt-ui

WorkflowRunHistory

Blocks

Browse workflow runs with search and status filters, a DataTable, and tabbed detail dialogs.

Related components

opt-ui

Select

Core

Build a dropdown selection with Root, Label, Trigger, Popover, and Item components.

opt-ui

Combobox

Core

Build autocomplete search with an input, popover, items, groups, group labels, and an empty state.

opt-ui

Button

Core

Use accessible buttons with primary, secondary, ghost, and danger variants, three sizes, icons, loading, and aria-busy states.

opt-ui

Switch

Core

Toggle a setting with three sizes and explicit accessible associations for labels and descriptions.

opt-ui

Textarea

Core

Enter multiline text with the same label, error, and hint API as Input.

opt-ui

Checkbox

Core

Use labeled checkboxes with descriptions, groups, and an indeterminate state synchronized to the DOM property.

PreviousAlertNextSwitch