DIV CSS 佈局教程網

Ajax 自動補全表單欄位完整實作與逐段解析
編輯:AJAX基礎知識     

輸入幾個字就自動列出可能的選項,這種「自動補全」在搜尋框裡很常見。做法是:先把候選清單用 Ajax 載入記憶體,之後每次按鍵都在前端比對,不必反覆請示伺服器。以下是一個以美國州名為例的完整範例。

HTML 部分

<!DOCTYPE html>
<html>
<head>
<title>Auto-fill Form Fields</title>
<link rel="stylesheet" href="script06.css" />
<script src="script06.js"></script>
</head>
<body>
<form action="#">
Please enter your state:<br>
<input type="text" id="searchField" autocomplete="off"><br>
<div id="popups"></div>
</form>
</body>
</html>

這裡最值得注意的是 autocomplete="off"。它雖然不是 W3C 標準的一部分,卻獲得了廣泛的跨瀏覽器支援。加上它,是為了關掉瀏覽器內建的歷史紀錄提示,改由我們自己的腳本接手自動補全,否則兩套提示會互相打架。

CSS 部分

body, #searchfield { font: 1.2em arial, helvetica, sans-serif; }
.suggestions { background-color: #FFF; padding: 2px 6px; border: 1px solid #000; }
.suggestions:hover { background-color: #69F; }
#popups { position: absolute; }
#searchField.error { background-color: #FFC; }

JavaScript 部分

window.onload = initAll;
var xhr = false;
var statesArray = new Array();

function initAll() {
    document.getElementById("searchField").onkeyup = searchSuggest;
    if (window.XMLHttpRequest) {
        xhr = new XMLHttpRequest();
    } else if (window.ActiveXObject) {
        try { xhr = new ActiveXObject("Microsoft.XMLHTTP"); } catch (e) {}
    }
    if (xhr) {
        xhr.onreadystatechange = setStatesArray;
        xhr.open("GET", "us-states.xml", true);
        xhr.send(null);
    } else {
        alert("Sorry, but I couldn't create an XMLHttpRequest");
    }
}

function setStatesArray() {
    if (xhr.readyState == 4) {
        if (xhr.status == 200) {
            if (xhr.responseXML) {
                var allStates = xhr.responseXML.getElementsByTagName("item");
                for (var i = 0; i < allStates.length; i++) {
                    statesArray[i] =
                        allStates[i].getElementsByTagName("label")[0].firstChild;
                }
            }
        } else {
            alert("There was a problem with the request " + xhr.status);
        }
    }
}

function searchSuggest() {
    var str = document.getElementById("searchField").value;
    document.getElementById("searchField").className = "";
    if (str != "") {
        document.getElementById("popups").innerHTML = "";
        for (var i = 0; i < statesArray.length; i++) {
            var thisState = statesArray[i].nodeValue;
            if (thisState.toLowerCase().indexOf(str.toLowerCase()) == 0) {
                var tempDiv = document.createElement("div");
                tempDiv.innerHTML = thisState;
                tempDiv.onclick = makeChoice;
                tempDiv.className = "suggestions";
                document.getElementById("popups").appendChild(tempDiv);
            }
        }
        var foundCt = document.getElementById("popups").childNodes.length;
        if (foundCt == 0) {
            document.getElementById("searchField").className = "error";
        }
        if (foundCt == 1) {
            document.getElementById("searchField").value =
                document.getElementById("popups").firstChild.innerHTML;
            document.getElementById("popups").innerHTML = "";
        }
    }
}

function makeChoice(evt) {
    if (evt) {
        var thisDiv = evt.target;
    } else {
        var thisDiv = window.event.srcElement;
    }
    document.getElementById("searchField").value = thisDiv.innerHTML;
    document.getElementById("popups").innerHTML = "";
}

運作流程拆解

載入候選資料。頁面載入時就發出一次 GET 請求抓 us-states.xml,在 setStatesArray() 中走訪每個 item 節點,取出其中的 label 節點文字,逐一存進 statesArray。之後所有的比對都在本地完成,不必再連伺服器。

捕捉每次按鍵。initAll() 把 searchField 的 onkeyup 指向 searchSuggest,先取得目前輸入值並清空欄位的 class。

比對規則。用 indexOf(...) == 0 而非單純的 indexOf(...) > -1,是為了只接受「開頭相符」的結果。否則輸入 Kansas 時,Arkansas 也會被列出來,那不是使用者想要的。比對前兩邊都轉小寫,可以讓大小寫不影響結果。

動態組出清單。每個符合的州名都包成一個 div,加上 suggestions 樣式與 onclick,再 append 到 popups 容器。獨立成 div 的好處是每個選項都能被 CSS 與 JavaScript 個別操作。

零筆與唯一筆的處理。比對完畢後統計 foundCt。若為 0,把 class 設成 error,欄位會變成淺黃底提示輸入有誤;若為 1,代表唯一命中,直接把完整州名填進欄位並清空彈出清單——使用者輸入 ca 就自動補成 California,不必再敲 lifornia。

滑鼠點選。makeChoice() 透過事件目標找出被點的 div,取其 innerHTML 填回欄位,最後清空清單。

若要在正式環境使用,建議把 XML 換成 JSON 並改用 JSON.parse,另外為鍵盤操作加上上下鍵與 Enter 的支援,才算完整的可存取性設計。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved