GRAPHNOTES

javascriptでフォームにサジェスト(検索補助)機能を実装する

日付:
2024年08月10日
カテゴリー:
HTML・CSS・PHP, Javascript

HTML5のフォームにはサジェスト・入力補助機能のdatalist要素がありますが、今回はそれではなく入力ワードに応じてHTMLを表示させる方法を取ってみます。

json

検索候補となるデータのリストです。

JSON
[
  { "id": 1, "name": "JavaScript" },
  { "id": 2, "name": "Java" },
  { "id": 3, "name": "Python" },
  { "id": 4, "name": "PHP" },
  { "id": 5, "name": "Ruby" },
  { "id": 6, "name": "React" },
  { "id": 7, "name": "Vue.js" },
  { "id": 8, "name": "TypeScript" },
  { "id": 9, "name": "HTML / CSS" }
]

HTML + CSS

HTML
<!DOCTYPE html>
<html lang="ja">
<head>
    <meta charset="UTF-8">
    <title>サジェスト機能サンプル</title>
    <style>
        .search-container {
            position: relative;
            width: 300px;
            margin: 50px auto;
            font-family: sans-serif;
        }
        input[type="text"] {
            width: 100%;
            padding: 8px;
            box-sizing: border-box;
        }
        #suggestions {
            position: absolute;
            top: 100%;
            left: 0;
            right: 0;
            border: 1px solid #ccc;
            background: #fff;
            list-style: none;
            margin: 0;
            padding: 0;
            max-height: 150px;
            overflow-y: auto;
            box-shadow: 0 4px 6px rgba(0,0,0,0.1);
        }
        #suggestions li {
            padding: 8px;
            cursor: pointer;
        }
        #suggestions li:hover {
            background: #f0f0f0;
        }
    </style>
</head>
<body>

    <div class="search-container">
        <form autocomplete="off" onsubmit="return false;">
            <input type="text" id="searchInput" placeholder="言語名を入力 (例: ja...)">
        </form>
        <ul id="suggestions"></ul>
    </div>

    <script src="script.js"></script>
</body>
</html>

javascript

JavaScript
document.addEventListener('DOMContentLoaded', () => {
    const searchInput = document.getElementById('searchInput');
    const suggestionsList = document.getElementById('suggestions');
    
    let searchData = [];

    // 1. ページ読み込み時にJSONデータを取得
    fetch('suggestions.json')
        .then(response => response.json())
        .then(data => {
            searchData = data;
        })
        .catch(error => console.error('JSONの読み込みに失敗しました:', error));

    // 2. 入力イベントの監視
    searchInput.addEventListener('input', (e) => {
        const keyword = e.target.value.toLowerCase().trim();
        suggestionsList.innerHTML = ''; // 一旦リストをクリア

        // 入力値が空の場合は候補を出さない
        if (keyword === '') {
            return;
        }

        // 3. JSONデータから部分一致するものを抽出
        const matches = searchData.filter(item => 
            item.name.toLowerCase().includes(keyword)
        );

        // 4. 一致した候補をリストとして描画
        matches.forEach(item => {
            const li = document.createElement('li');
            li.textContent = item.name;
            
            // 候補をクリックしたときに入力欄に値を反映
            li.addEventListener('click', () => {
                searchInput.value = item.name;
                suggestionsList.innerHTML = ''; // リストを閉じる
            });

            suggestionsList.appendChild(li);
        });
    });

    // 5. フォームの外側をクリックしたら候補を閉じる
    document.addEventListener('click', (e) => {
        if (!e.target.closest('.search-container')) {
            suggestionsList.innerHTML = '';
        }
    });
});

動作させる際の注意点

ブラウザのセキュリティ制限(CORSポリシー)により、file:///(ローカルファイルを直接ダブルクリックして開く方法)だと fetch('suggestions.json') がブロックされてエラーになることがあります。

動作確認の際は、VS Codeの拡張機能 「Live Server」 や、簡易的なローカルサーバー(Pythonの http.server など)を使ってローカルホスト経由で表示させてください。