萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

原生 JavaScript 實現輸入框自動完成/關鍵字聯想下拉建議

搜索框、標籤輸入、選擇器等場景常需「輸入即時匹配數據源顯示下拉建議」。本文提供一個**零依賴、數據源可配置、鍵盤導航、防抖、高亮關鍵字**的完整自動完成組件實現,並分析向後端請求數據的擴展點。

效果演示

輸入框聚焦輸入 → 300ms 防抖 → 過濾本地數據源 → 渲染下拉列表 → 鍵盤 ↑↓ 選擇 → Enter/點擊 填入 → 失焦隱藏。

完整組件代碼 (ES5 兼容)

<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);

進階功能清單 (按需擴展)

  • 分組/分類顯示 (如「熱門搜索」、「商品」、「店鋪」)。
  • 異步請求緩存 (LRU Map) 避免重複請求相同關鍵字。
  • 無障礙支援:role="combobox"、aria-expanded、aria-activedescendant。
  • 多選模式:選中後生成 Tag 而非替換輸入框值。
  • 虛擬滾動:數據量大時只渲染可視區。

生產級推薦庫

  • 原生 JS:awesomplete (2KB)、autoComplete.js (7KB)。
  • Vue:@vueuse/autocomplete、element-plus ElAutocomplete、ant-design-vue AutoComplete。
  • React:downshift (頭部無樣式)、react-select、MUI Autocomplete。

手寫自動完成組件是理解「受控/非受控組件、狀態機、異步流控、無障礙」的最佳練習,建議每位前端工程師至少完整實現一次。

copyright © 萬盛學電腦網 all rights reserved