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

Text Field Textarea

여러 줄의 긴 텍스트를 입력받고 자동으로 높이를 조절하는 컴포넌트입니다.

사용 가능 버전@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"

TextFieldTextarea

Prop

Type

asChild?boolean | undefined

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

Default

false

autoresize?boolean | undefined

If true, the textarea will automatically resize based on its content.

Default

true

Examples

State

Enabled

Disabled

Read Only

Size

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

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

Sizing

<TextFieldTextarea>에 height 관련 스타일을 직접 지정하여 높이를 고정하거나 최소/최대 높이를 설정할 수 있습니다.

Fixed Height

Auto Height with Constraints

Customizable Parts

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

Formatting

Slicing

Last updated on 2026. 8. 2.