輸入幾個字就自動列出可能的選項,這種「自動補全」在搜尋框裡很常見。做法是:先把候選清單用 Ajax 載入記憶體,之後每次按鍵都在前端比對,不必反覆請示伺服器。以下是一個以美國州名為例的完整範例。
<!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 標準的一部分,卻獲得了廣泛的跨瀏覽器支援。加上它,是為了關掉瀏覽器內建的歷史紀錄提示,改由我們自己的腳本接手自動補全,否則兩套提示會互相打架。
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; }
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 的支援,才算完整的可存取性設計。