Text field

일정 높이의 필드 안에 한 줄 이하의 값을 입력할 수 있는 컴포넌트로 Heading, Placeholder, Description 등의 요소를 활용하여 사용자가 입력할 내용의 형식을 보다 명확하게 안내합니다.

Anatomy

  1. 1Heading
  2. 2Placeholder
  3. 3Description
  4. 4Leading icon
  5. 5Field
  6. 6Required badge
  7. 7Trailing contents
  8. 8Trailing button

Variants

Description

Leading icon
Trailing button
Trailing contents

States

Input mask

Call number

휴대전화 번호 입력 시 4자 단위로 하이픈(-)이 포함된 형식을 사용하는 것을 권장합니다. 컴포넌트 자체 지원이 아닌 각
프로젝트 담당자들간의 커뮤니케이션으로 적용 가능합니다.

Card number

카드번호 16자 입력 시 4자 단위로 하이픈(-)이 포함된 형식을 사용하는 것을 권장합니다. 컴포넌트 자체 지원이 아닌 각 프로젝트 담당자들간의 커뮤니케이션으로 적용가능합니다.

Date

날짜를 직접 입력할 시 YYYY. MM. DD 양식 사용을 권장하며, 가급적 Text input을 기반으로 한 Date picker 컴포넌트 사용을 권장합니다.

Gap

필드 간의 간격은 기본적으로 Description의 활성 여부와 관계없이 동일한 간격을 유지합니다. 단, 레이아웃이 제한적인 상황일 경우 필드가 고정으로 위치하여 Description 만큼 간격이 줄어들 수 있습니다.

Validation check

값을 입력하고 확인 버튼을 눌러 유효성 검사를 실시하도록 설계하는 것을 권장합니다.

Usage

Password

패스워드 입력 시 Hidden과 Visible 옵션 제공을 권장하며 해당 옵션 제공 시 기본 값은 Hidden 상태입니다.

Certifications

Trailing button을 활성하여 사용하며 인증번호 입력 필드가 노출 될 때 포커스가 이동합니다. 행동을 유도하는 발송, 재발송과 같은 특정 행동을 유도하는 버튼은 Normal을 사용하며 행동을 종료하는 ‘확인’은 Assistive를 권장합니다. 일정 시간 이후 필드의 버튼과 타이머가 비활성화 됩니다.

Unit

Trailing content의 ‘Text’를 활용하여 특정 고정 값에 대한 Suffix 값을 둘 수 있습니다.

How to use

Do

실패 사유를 명확하게 안내하여 사용자에게 명확한 행동을 유도합니다.

Don’t

버튼명을 6자 이상으로 길게 적용하지 않습니다.

© 2026 Wanted Lab, Inc.