React

Text Field Input

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

Installation

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

Props

TextField

Prop

Type

label?React.ReactNode
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
defaultValue?string | undefined
name?string | undefined
value?string | undefined

TextFieldInput

Prop

Type

Examples

State

Enabled

Disabled

Read Only

Size

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

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

Customizable Parts

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

Prefix

Suffix

Both Affixes

Indicator

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

Grapheme Count

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

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

Use Cases

Form (Uncontrolled)

React Hook Form

Number Formatting

Slicing

Last updated on

On this page