검색창에 글자를 치는 동안 추천어 목록이 열리고 점점 좁혀지며, 화살표 키로 한 줄씩 고르다 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만드는 순서
각 단계의 버튼을 누르면 위의 데모가 그 단계까지의 모습으로 바뀝니다.
글자만 치는 검색창
글자를 하나씩 입력하는 검색창만 둔다. 깜빡이는 커서는 있지만 목록은 열리지 않아서 끝까지 쳐야 결과가 나온다.
text = typed[i]; // 키를 칠 때마다 한 글자(음절)씩 늘어남
추천어 목록 열고 좁히기
마지막 입력 뒤 0.15초 쉬면, 입력한 글자로 시작하는 추천어만 골라 최대 5줄 보여 준다. 글자를 칠수록 줄이 줄어든다. 이렇게 잠깐 쉬었다 갱신하는 것을 디바운스라고 한다.
‘확인’은 출처 문서에서 사실로 확인한 내용, ‘추정’은 결과물을 보고 추론한 내용, ‘원본 없음’은 흔히 쓰이지만 대표 원본 사례를 확인하지 못해 성공 사례로 제시하지 않은 기법이다.
확인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