용어 · UI 화면 연출

검색창 자동완성

Search Autocomplete

검색창에 글자를 치는 동안 추천어 목록이 열리고 점점 좁혀지며, 화살표 키로 한 줄씩 고르다 Enter 를 누르면 확정되는 입력 도움 움직임이다.

기본행동 안내설명

01직접 돌려 보기

‘연출 전’은 대충 시켰을 때를 가정해 만든 화면이고 실제 AI 결과와 다를 수 있다.

연출 전흔한 첫 결과
연출 후완성본
0.00초 / 4.0초

02이름으로 시키는 지시문

대충 시킴검색창에 자동완성 넣어줘→ 목록이 몇 줄인지, 언제 갱신되는지, 키보드로 어떻게 고르는지가 빠진 채라서 대개 글자마다 목록이 깜빡이거나 마우스로만 고를 수 있는 목록이 나온다.
이름으로 시킴글자 간격 0.35초, 마지막 입력 뒤 0.15초 쉬면 갱신, 최대 5줄, 아래 화살표 키로 강조, Enter 로 확정→ ‘서울 맛집’을 치는 동안 5줄에서 4줄로 좁혀지는 목록이 열리고, ↓ ↓ Enter 로 ‘서울 맛집 지도’가 확정되는 검색창
Claude Code · Codex에 그대로 붙여 넣기

검색창 하나가 글자를 치는 동안 추천어 목록을 보여 주는 장면을 만들어줘.

  • 화면은 640×360, 배경은 밝은 회백색(#f2f2f0에서 #e4e4e1로 내려가는 그라디언트). 가운데 위쪽에 흰색 알약 모양 검색창(440×46, 돋보기 아이콘, 입력 중에는 빨간 테두리와 깜빡이는 빨간 커서)이 있고 그 아래로 목록 패널이 열린다. 포인트 색은 빨강(#ff3b1f) 하나만 쓴다.
  • 타이핑은 ‘서’, ‘서울’, ‘서울 ’, ‘서울 맛’, ‘서울 맛집’ 순서로 0.5초부터 시작하고 글자 하나를 치는 간격 0.35초.
  • 목록은 마지막 입력 뒤 0.15초 쉬면 갱신(디바운스 0.15초)하고 한 번에 최대 5줄. 추천어는 ‘서울 맛집’ ‘서울 맛집 지도’ ‘서울 맛집 예약’ ‘서울 날씨’ ‘서울 지하철 노선도’ ‘서울 맛집 추천’ ‘서울숲 산책’ ‘서울역 주차’ 중 입력한 글자로 시작하는 것만 보여 주므로 글자를 칠수록 줄이 줄어든다. 목록은 0.18초 동안 위에서 내려오며 나타난다(outCubic).
  • 추천어의 입력한 부분은 회색 500, 이어지는 부분은 검정 700. 첫 줄 앞에는 시계 아이콘(최근 검색), 나머지에는 돋보기 아이콘.
  • 키보드3.0초에 아래 화살표 키로 첫 줄이 강조되고(옅은 빨강 배경과 왼쪽 빨간 막대), 3.45초에 한 번 더 눌러 둘째 줄로 내려가며, 4.0초에 Enter 를 누르면 검색창 글자가 ‘서울 맛집 지도’로 바뀌고 목록이 닫히며 검색 결과 카드 3개가 0.35초 동안 올라온다. 지금 누른 키(↓ ↓ Enter)는 오른쪽 아래에 작은 키캡으로 보여 준다. 검색창 글자는 Enter 를 누르기 전까지 바뀌지 않는다.
  • 오른쪽 위에는 지금 단계를 알려 주는 작은 이름표를 직각에 가까운 모서리로 두고, 왼쪽에 빨간 줄을 붙인다.
  • 연출 전은 글자만 치고 목록은 열리지 않는 모습(끝까지 쳐야 결과를 알 수 있음).
  • 금지한 글자마다 목록이 깜빡이며 다시 열리는 것, 마우스로만 고를 수 있는 것, 입력한 글자를 목록이 가리는 것.

구현에 쓰이는 기술: HTML: <input> + 목록(ul) + role="combobox" / role="listbox" / role="option"ARIA: aria-expanded · aria-controls · aria-activedescendant · aria-autocompleteJS: input 이벤트 + 디바운스(setTimeout) + 입력한 글자로 시작하는 항목 필터링CSS transition: 목록 opacity · transform서버 검색 API(추천어 제공)와 연결

03응용 팁

팁은 데모에서 값만 바꿔 같은 장면과 비교한 것이다. AI가 같은 결과를 내는지는 직접 해 봐야 안다.

1

목록이 한참 뒤에야 떠

글자를 친 뒤 한참 있어야 목록이 열려 도움이 안 될 때

지시문에서
마지막 입력 뒤 0.15초 쉬면 갱신(디바운스 0.15초)
이렇게 바꾸세요
마지막 입력 뒤 0.6초 쉬면 갱신(디바운스 0.6초)
그러면
‘서울’까지 친 1.05초 시점에 0.15초 설정은 목록이 이미 열려 있지만 0.6초 설정은 아직 비어 있다. 글자마다 깜빡이는 일은 줄어도 도움이 늦게 온다.
확인
2

목록이 길어서 아래 화면을 가린다

추천어가 많아 목록이 아래 내용을 덮을 때

지시문에서
한 번에 최대 5줄
이렇게 바꾸세요
한 번에 최대 3줄
그러면
5줄이던 패널이 3줄로 낮아져 아래 화면이 덜 가린다. ‘서울 날씨’와 ‘서울 지하철 노선도’ 같은 뒤쪽 후보는 아예 보이지 않게 된다.
확인
3

타자가 빨라서 목록이 못 따라온다

빠르게 치는 사람 기준으로 입력과 목록 갱신이 어떻게 어긋나는지 보고 싶을 때

지시문에서
글자 하나를 치는 간격 0.35초
이렇게 바꾸세요
글자 하나를 치는 간격 0.2초
그러면
1.4초 시점에 검색창은 ‘서울 ’에서 ‘서울 맛집’까지 앞서 가고, 목록은 5줄에서 4줄로 좁혀지지만 아직 ‘서울 맛’까지만 반영해 ‘집’이 굵은 글자로 남아 있다.
확인

04만드는 순서

각 단계의 버튼을 누르면 위의 데모가 그 단계까지의 모습으로 바뀝니다.

  1. 글자만 치는 검색창

    글자를 하나씩 입력하는 검색창만 둔다. 깜빡이는 커서는 있지만 목록은 열리지 않아서 끝까지 쳐야 결과가 나온다.

    text = typed[i];   // 키를 칠 때마다 한 글자(음절)씩 늘어남
  2. 추천어 목록 열고 좁히기

    마지막 입력 뒤 0.15초 쉬면, 입력한 글자로 시작하는 추천어만 골라 최대 5줄 보여 준다. 글자를 칠수록 줄이 줄어든다. 이렇게 잠깐 쉬었다 갱신하는 것을 디바운스라고 한다.

    const shownQuery = lastTyped(t - DEBOUNCE);
    const items = ALL.filter(x => x.startsWith(shownQuery)).slice(0, SHOWN);
  3. 입력한 부분과 이어지는 부분 나누기

    추천어에서 이미 친 부분은 회색, 이어지는 부분은 굵은 검정 글자로 나눈다. 첫 줄 시계(최근 검색)와 나머지 돋보기 아이콘으로 줄의 종류도 알려 준다.

    draw(item.slice(0, q.length), gray);
    draw(item.slice(q.length), ink, bold);
  4. 화살표로 고르고 Enter 로 확정

    초점은 입력 칸에 그대로 둔 채 아래 화살표 키로 강조 줄만 옮긴다. 강조가 어디 있든 입력 칸 글자는 Enter 전까지 변하지 않고, Enter 를 누르는 순간 추천어로 바뀌며 목록이 닫힌다.

    input.setAttribute('aria-activedescendant', option.id);
    if (key === 'Enter') { input.value = option.text; closeList(); }

05전문용어 풀이

자동완성Autocomplete / Typeahead

입력하는 동안 어울리는 후보를 미리 보여 주는 기능이다. 끝까지 치지 않아도 되게 도와준다.

AI에게“검색창에 추천어 자동완성 목록을 보여줘”
디바운스Debounce

입력이 멈추고 짧게(예를 들어 0.15초) 기다린 뒤에 처리하는 방법으로, 한 글자마다 목록이 깜빡이는 것을 막는다.

AI에게마지막 입력 뒤 0.15초 쉬면 갱신
콤보박스Combobox

입력 칸과 후보 목록이 짝을 이룬 입력 도구. 글자를 직접 쓰거나 목록에서 고를 수 있다.

AI에게“접근성: 입력 칸은 combobox, 목록은 listbox 로”
활성 줄Active option

화살표 키로 지금 가리키고 있는 목록의 줄이다. 옅은 배경과 왼쪽 막대로 보여 주고, 입력 칸 글자는 Enter 전까지 그대로 둔다.

AI에게“아래 화살표 키로 한 줄씩 내려가며 강조”
키캡Keycap

누른 키를 보여 주는 작은 키 모양 표시로, 키보드 조작을 영상으로 설명할 때 쓴다.

AI에게오른쪽 아래에 누른 키를 키캡으로
최근 검색Recent searches

예전에 직접 찾아본 말을 목록 맨 위에 올려 두는 줄이다. 이 데모에서는 시계 아이콘으로 구분한다.

AI에게“첫 줄은 시계 아이콘을 붙인 최근 검색으로”

06결과를 받으면 이것부터 확인

  • 연출 전에는 글자를 쳐도 목록이 열리지 않는가
  • 글자를 칠수록 목록이 5줄에서 4줄로 줄어든다
  • 추천어 안에서 입력한 부분(회색)과 이어지는 부분(굵은 검정)이 다르게 보인다
  • 아래 화살표 키로는 강조 줄만 내려가고 검색창 글자는 Enter 를 누른 뒤에야 바뀌며, 그때 결과 카드 3개가 나타난다

07이럴 때 쓰세요

  • 검색 기능이 있는 쇼핑몰이나 앱을 소개하는 영상
  • 입력하는 동안 목록이 열리고 좁혀지는 흐름을 시안으로 보여 줄 때
  • 키보드만으로 목록을 고르게 하는 규칙을 기획서에 적을 때

08같이 쓰는 용어

09근거와 확인 범위

‘확인’은 출처 문서에서 사실로 확인한 내용, ‘추정’은 결과물을 보고 추론한 내용, ‘원본 없음’은 흔히 쓰이지만 대표 원본 사례를 확인하지 못해 성공 사례로 제시하지 않은 기법이다.

  • 확인W3C WAI-ARIA 실천 가이드의 콤보박스 패턴은 입력 칸과 연결된 팝업(목록 등)에서 값을 고르는 구성이다. 그중 목록 자동완성(직접 선택) 방식은 입력한 글자에 맞는 제안을 팝업에 보여 주되 아무것도 자동으로 고르지 않아서, 사용자가 고르기 전까지는 입력한 글자가 그대로 값이 된다. W3C WAI-ARIA APG — Combobox Pattern
  • 확인목록 자동완성 예제에서 입력 칸은 role=combobox, 팝업은 role=listbox, 줄은 role=option 이다. 아래 화살표 키는 목록을 열고 다음 줄로, 위 화살표 키는 이전 줄로 강조를 옮기고, Enter 는 강조된 줄의 값을 입력 칸에 넣고 목록을 닫으며, Esc 는 목록을 닫는다(이미 닫혀 있으면 입력 칸을 비운다). 키보드 초점은 입력 칸에 머물고 aria-activedescendant 가 강조된 줄을 가리킨다. W3C WAI-ARIA APG — Editable Combobox With List Autocomplete