프리뷰 또는 이전 버전의 문서를 보고 있습니다.seed-design.io 방문
우리는 왜 디자인 엔지니어를 찾게 됐을까
Skip to Content
React

Text Field Input

한 줄 텍스트를 입력받는 컴포넌트입니다.

사용 가능 버전@seed-design/[email protected], @seed-design/[email protected]

Installation

npx @seed-design/cli@latest add ui:text-field

Props

TextField

Prop

Type

label?React.ReactNode
labelWeight?"bold" | "medium" | undefined

Default

"medium"

indicator?React.ReactNode
prefixIcon?React.ReactNode
prefix?React.ReactNode
suffixIcon?React.ReactNode
suffix?React.ReactNode
description?React.ReactNode
errorMessage?React.ReactNode
hideCharacterCount?boolean | undefined
maxGraphemeCount?number | undefined
showRequiredIndicator?boolean | undefined
fieldRef?React.Ref<HTMLDivElement> | undefined
onValueChange?((values: { value: string; graphemes: string[]; slicedValue: string; slicedGraphemes: string[]; }) => void) | undefined
value?string | undefined
defaultValue?string | undefined
required?boolean | undefined

Default

false

disabled?boolean | undefined

Default

false

readOnly?boolean | undefined

Default

false

invalid?boolean | undefined

Default

false

name?string | undefined
variant?"outline" | "underline" | undefined
  • outline: 기본 스타일입니다.
  • underline: 화면에 하나의 Input만 있는 경우 사용을 권장합니다.

Default

"outline"

size?"large" | "medium" | "responsive" | undefined
  • large: 뷰포트 너비와 관계없이 사용할 수 있습니다.
  • medium: Breakpoint lg 이상(데스크톱)에서만 사용하고, 모바일에서는 사용하지 않습니다. 정밀한 선택이 가능한 마우스 입력 환경에서 사이즈를 더 작게 만들고자 할 때 사용합니다.
  • responsive: 뷰포트 너비에 따라 적용되는 사이즈가 달라집니다. Breakpoint lg 미만에서는 large, lg 이상에서는 medium으로 적용됩니다.

Default

"large"

TextFieldInput

Prop

Type

asChild?boolean | undefined

Whether the element should be rendered as a child of a slot.

Default

false

Examples

State

Enabled

Disabled

Read Only

Size

size로 TextField의 크기를 정합니다. (default: large)

responsive는 화면 너비에 따라 size가 자동으로 전환되는 값입니다. 여러 화면 너비를 함께 지원하는 제품에서 size=responsive를 사용하여 대응합니다.

Customizable Parts

아이콘만으로 맥락을 전달하려고 할 때 유의하세요. description 또는 label에 아이콘의 의미를 명확히 설명하는 텍스트를 포함하거나, 아이콘이 스크린 리더에 의해 읽히도록 설정하고 aria-label을 제공하세요.

Prefix

https://
https://

Suffix

cm
cm

Both Affixes

만세
만세

Indicator

indicator 또는 showRequiredIndicator prop을 사용할 수 있습니다.

Grapheme Count

자소 단위로 쪼개진 value에 관한 정보를 onValueChange 콜백에서 graphemes와 slicedGraphemes로 제공합니다.

자소 분리는 unicode-segmenter를 통해 이루어집니다.

graphemes.length: 0value.length: 0graphemes: []value:

Use Cases

Form (Uncontrolled)

React Hook Form

Number Formatting

Slicing

Last updated on 2026. 8. 2.