搜索框、標籤輸入、選擇器等場景常需「輸入即時匹配數據源顯示下拉建議」。本文提供一個**零依賴、數據源可配置、鍵盤導航、防抖、高亮關鍵字**的完整自動完成組件實現,並分析向後端請求數據的擴展點。
輸入框聚焦輸入 → 300ms 防抖 → 過濾本地數據源 → 渲染下拉列表 → 鍵盤 ↑↓ 選擇 → Enter/點擊 填入 → 失焦隱藏。
<style>
.autocomplete-wrap { position: relative; display: inline-block; width: 300px; }
.autocomplete-input { width: 100%; padding: 8px 12px; font-size: 14px; border: 1px solid #ccc; border-radius: 4px; box-sizing: border-box; }
.autocomplete-dropdown { position: absolute; top: 100%; left: 0; right: 0; background: #fff; border: 1px solid #ccc; border-top: none; border-radius: 0 0 4px 4px; max-height: 200px; overflow-y: auto; z-index: 100; display: none; box-shadow: 0 4px 8px rgba(0,0,0,0.1); }
.autocomplete-item { padding: 8px 12px; cursor: pointer; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
.autocomplete-item:hover, .autocomplete-item.selected { background: #f0f0f0; }
.autocomplete-item mark { background: #ff0; padding: 0 2px; border-radius: 2px; }
</style>
<div class="autocomplete-wrap">
<input type="text" class="autocomplete-input" id="autoInput" placeholder="輸入關鍵字..." autocomplete="off" />
<div class="autocomplete-dropdown" id="autoDropdown"></div>
</div>
<script>
(function() {
// === 配置區 ===
var dataSource = [ // 可替換為異步請求
"Apple iPhone 15", "Apple MacBook Pro", "Apple Watch Ultra",
"Samsung Galaxy S24", "Samsung Galaxy Tab", "Samsung TV",
"Xiaomi 14 Ultra", "Xiaomi Pad 6", "Xiaomi Band 8",
"Huawei Mate 60", "Huawei Watch GT", "Huawei Laptop"
];
var debounceMs = 300;
var minChars = 1;
var maxItems = 10;
// === 狀態 ===
var $input = document.getElementById('autoInput');
var $dropdown = document.getElementById('autoDropdown');
var selectedIndex = -1;
var debounceTimer = null;
var currentItems = [];
// === 工具函數 ===
function escapeHtml(str) {
return str.replace(/[&<>"']/g, function(c) {
return {'&':'&','<':'<','>':'>','"':'"',"'":'''}[c];
});
}
function highlight(text, keyword) {
if (!keyword) return escapeHtml(text);
var regex = new RegExp('(' + keyword.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') + ')', 'gi');
return escapeHtml(text).replace(regex, '$1');
}
function render(items) {
currentItems = items;
$dropdown.innerHTML = items.map(function(item, idx) {
return '' + highlight(item, $input.value) + '';
}).join('');
$dropdown.style.display = items.length ? 'block' : 'none';
selectedIndex = -1;
}
function selectItem(index) {
if (index < 0 || index >= currentItems.length) return;
$input.value = currentItems[index];
$dropdown.style.display = 'none';
$input.focus();
}
function moveSelection(dir) { // dir: 1 down, -1 up
var len = currentItems.length;
if (!len) return;
selectedIndex = (selectedIndex + dir + len) % len;
var items = $dropdown.querySelectorAll('.autocomplete-item');
items.forEach(function(el, i) { el.classList.toggle('selected', i === selectedIndex); });
if (items[selectedIndex]) items[selectedIndex].scrollIntoView({block: 'nearest'});
}
// === 事件綁定 ===
$input.addEventListener('input', function() {
clearTimeout(debounceTimer);
debounceTimer = setTimeout(function() {
var kw = $input.value.trim();
if (kw.length < minChars) { render([]); return; }
var filtered = dataSource.filter(function(item) {
return item.toLowerCase().indexOf(kw.toLowerCase()) > -1;
}).slice(0, maxItems);
render(filtered);
}, debounceMs);
});
$input.addEventListener('focus', function() {
if ($input.value.trim().length >= minChars) {
$input.dispatchEvent(new Event('input')); // 觸發過濾
}
});
$input.addEventListener('keydown', function(e) {
if (e.key === 'ArrowDown') { e.preventDefault(); moveSelection(1); }
else if (e.key === 'ArrowUp') { e.preventDefault(); moveSelection(-1); }
else if (e.key === 'Enter') { e.preventDefault(); selectItem(selectedIndex); }
else if (e.key === 'Escape') { $dropdown.style.display = 'none'; }
});
$dropdown.addEventListener('click', function(e) {
var item = e.target.closest('.autocomplete-item');
if (item) selectItem(parseInt(item.dataset.index, 10));
});
document.addEventListener('click', function(e) {
if (!$input.contains(e.target) && !$dropdown.contains(e.target)) {
$dropdown.style.display = 'none';
}
});
})();
</script>
function fetchSuggestions(keyword, callback) {
// 取消上一次請求
if (fetchSuggestions.controller) fetchSuggestions.controller.abort();
fetchSuggestions.controller = new AbortController();
fetch('/api/suggest?q=' + encodeURIComponent(keyword), {signal: fetchSuggestions.controller.signal})
.then(r => r.json())
.then(data => callback(data.items || []))
.catch(e => { if (e.name !== 'AbortError') console.error(e); });
}
// 在 input 事件中替換本地過濾為:
// fetchSuggestions(kw, render);
role="combobox"、aria-expanded、aria-activedescendant。awesomplete (2KB)、autoComplete.js (7KB)。@vueuse/autocomplete、element-plus ElAutocomplete、ant-design-vue AutoComplete。downshift (頭部無樣式)、react-select、MUI Autocomplete。手寫自動完成組件是理解「受控/非受控組件、狀態機、異步流控、無障礙」的最佳練習,建議每位前端工程師至少完整實現一次。