Autocomplete

사용자가 텍스트를 입력할 때 실시간으로 관련된 옵션을 제안하여 빠르고 정확한 입력을 돕는 요소입니다. 텍스트 입력 필드와 Menu가 결합된 형태로, 입력 오류를 방지하며 사용자가 가능한 옵션을 탐색할 수 있도록 지원합니다.

Anatomy

  1. 1Container
  2. 2Direct input
  3. 3Heading
  4. 4Cell

Variants

Variants
Direct input

States

Size

400px의 고정된 높이를 가지고 있습니다. 단, 내부 콘텐츠들의 높이가 400px을 초과하지 않을 경우 내부 콘텐츠에 맞게 높이 가 조정됩니다. 호출 요소와의 간격유지를 위해 8px의 상하 여백을 포함합니다.

Min and max

  • Width: 최소 140px, Default로 320px의 너비를 유지합니다. 단, 8배수 간격으로 너비를 늘릴 수 있습니다.
  • Height: 최대 400px의 높이를 가집니다.

Sticky title

일정 구간마다 섹션의 타이틀을 둘 수 있습니다. 타이틀은 스크롤 시 상단에 고정됩니다.

Usage

With combobox

Combobox는 사용자가 직접 입력과 선택을 동시에 할 수 있는 필드 요소로 값을 보다 정확하게 입력할 수 있습니다. 입력한 값은 ‘Chip’, 혹은 ‘Text’로 표현됩니다.

  • Render=Chip: 2개 이상의 값이 입력 될 때 사용 권장합니다.
  • Render=Text: 1개의 값만 입력 될 때 사용 권장합니다.

With text field

이메일, 사용자 검색과 같은 상황에서 타이핑의 수고를 줄임과 동시에 입력 오류를 방지할 때 사용합니다.

With select

Select에서는 Menu와 Auto complete가 조합된 형태를 사용할 수 있습니다. 선택할 수 있는 리스트의 양이 50개 이상일 때 Search field를 함께 배치함으로써 항목의 탐색이 용이하도록 돕습니다.

How to use

Do

Divider가 위치할 수 있으며 아이콘 변경, 타입이 다른 Cell이 함께 쓰일 수 있습니다.

Don’t

Auto Complete에 Action area를 배치할 수 없습니다.

Customize

Auto Complete
typography
padding

© 2026 Wanted Lab, Inc.