搜尋框的「輸入即提示」是使用者最熟悉的高CP值功能之一:打兩個字就跳出候選,不用把整句話打完。它的實作由三個部分組成——前端攔截鍵盤輸入、以非同步請求向後端要候選、再把結果渲染成下拉清單。
<style type="text/css" media="screen">
body { font: 11px arial; }
.suggest_link {
width: 120px; background-color: #FFFFFF; padding: 2px 6px;
}
.suggest_link_over {
width: 120px; background-color: #E8F2FE; padding: 2px 6px;
}
#suggestResult {
position: absolute; background-color: #FFFFFF;
text-align: left; border: 1px solid #000000;
}
.input_on, .input_move {
padding: 2px 8px 0pt 3px; height: 18px;
border: 1px solid #999; background-color: #FFFFCC;
}
.input_off, .input_out {
padding: 2px 8px 0pt 3px; height: 18px;
border: 1px solid #CCC; background-color: #FFF;
}
</style>
下拉層用 position: absolute 疊在輸入框下方,每個候選項目是一個 div,滑過時換 class 達到高亮效果。
var $ = document.getElementById;
function createXMLHttpRequest() {
var obj;
if (window.XMLHttpRequest) {
obj = new XMLHttpRequest(); // 標準瀏覽器
} else if (window.ActiveXObject) {
try {
obj = new ActiveXObject("Msxml2.XMLHTTP"); // 新版 IE
} catch (e) {
try {
obj = new ActiveXObject("Microsoft.XMLHTTP"); // 舊版 IE
} catch (e) {}
}
}
return obj;
}
這段相容性程式在今天已無必要,保留是為了說明歷史脈絡——所有現代瀏覽器都支援標準的 XMLHttpRequest,甚至可以直接用 fetch。
function searchSuggest() {
var inputField = $("txtSearch");
var suggestText = $("suggestResult");
if (inputField.value.length > 0) {
var o = createXMLHttpRequest();
var url = "SearchResult.ashx?searchText=" + escape(inputField.value);
o.open("GET", url, true);
o.onreadystatechange = function () {
if (o.readyState == 4 && o.status == 200) {
var sourceItems = o.responseText.split("\n");
if (sourceItems.length > 1) {
suggestText.style.display = "";
suggestText.innerHTML = "";
for (var i = 0; i < sourceItems.length - 1; i++) {
var sourceText = sourceItems[i].split("@")[1];
var sourceValue = sourceItems[i].split("@")[0];
var s = '<div onmouseover="javascript:suggestOver(this);" ';
s += ' onmouseout="javascript:suggestOut(this);" ';
s += " onclick=\"javascript:setSearch('" + sourceText + "','" + sourceValue + "');\" ";
s += ' class="suggest_link" >' + sourceText + '</div>';
suggestText.innerHTML += s;
}
} else {
suggestText.style.display = "none";
}
}
};
o.send(null);
} else {
suggestText.style.display = "none";
}
}
// 延遲送出,避免每打一個字就發一次請求
function delayExecute() {
$("valueResult").value = "";
window.setTimeout(searchSuggest, 800);
}
function suggestOver(div_value) { div_value.className = "suggest_link_over"; }
function suggestOut(div_value) { div_value.className = "suggest_link"; }
function setSearch(a, b) {
$("txtSearch").value = a;
$("valueResult").value = b;
var div = $("suggestResult");
div.innerHTML = "";
div.style.display = "none";
}
function showResult() {
alert($("txtSearch").value + $("valueResult").value);
}
值得注意的設計細節:候選資料格式是「值@文字」以換行分隔,前端用 split("@") 拆開。同時把「顯示的文字」與「實際的值」分開存放——前者填進輸入框給使用者看,後者存在隱藏欄位 valueResult 裡送出表單。這是好習慣,因為顯示用的字串未必等於資料庫的實際鍵值。
<form id="form1" action="">
<input type="text" id="txtSearch" name="txtSearch" onkeyup="delayExecute();"
size="20" class="input_out"
onfocus="this.className='input_on'"
onblur="this.className='input_off'" />
<input type="hidden" id="valueResult" name="valueResult" value="" />
<br />
<div id="suggestResult" style="display: none"></div>
<br />
<input id="button1" type="button" value="提交" onclick="showResult();" />
</form>
<%@ WebHandler Language="C#" Class="SearchResult" %>
using System;
using System.Web;
using System.Data;
public class SearchResult : IHttpHandler {
public void ProcessRequest(HttpContext context) {
object QueryWord = context.Request.QueryString["searchText"];
if (QueryWord != null && QueryWord.ToString().Trim().Length > 0) {
DataTable dt = getDB();
string returnText = "";
if (dt != null && dt.Rows.Count > 0) {
DataRow[] dr = dt.Select("name like '%" + QueryWord.ToString() + "%'");
for (int i = 0; i < dr.Length; i++) {
returnText += dr[i]["id"].ToString() + "@" + dr[i]["name"].ToString() + "\n";
}
}
context.Response.Write(returnText);
context.Response.End();
}
}
public bool IsReusable { get { return false; } }
private DataTable getDB() {
DataTable dt = new DataTable();
dt.Columns.Add("id");
dt.Columns.Add("name");
dt.Columns.Add("age");
dt.Rows.Add(new object[] { "000001", "張三", "26" });
dt.Rows.Add(new object[] { "000002", "張曉", "26" });
dt.Rows.Add(new object[] { "000003", "張嵐", "27" });
dt.Rows.Add(new object[] { "000004", "李四", "25" });
dt.Rows.Add(new object[] { "000005", "李星", "27" });
return dt;
}
}
上面是完整的可運作範例,但若要用在真實專案,有幾點一定要改:
SQL 注入。 dt.Select("name like '%" + QueryWord + "%'") 是把使用者輸入直接串進查詢字串。使用者輸入 ' or '1'='1 就能改寫查詢邏輯。務必改用參數化查詢(SqlParameter),讓資料庫驅動負責轉義。
XSS。 前端把後端回傳的字串直接塞進 innerHTML,且用字串拼接生成 onclick。若候選資料中含有引號或標籤,就會破壞結構甚至執行任意腳本。改用 DOM API 建立元素、以 textContent 填入文字、用 addEventListener 綁定事件。
延時 800ms 太長。 更好的做法是 debounce 250–300ms,並在請求未回來前取消前一次(AbortController),避免舊回應覆蓋新結果的「排序錯亂」問題。
格式改用 JSON。 自訂的「換行分隔 + @ 分隔」在資料含換行時就解不開了。改成 [{id, name}] 的 JSON 回應,前端用 JSON.parse 或 response.json() 處理,穩健得多。
鍵盤操作。 完整的智慧提示需要支援上下鍵選擇、Enter 確認、Esc 關閉,並用 role="listbox"、role="option" 與 aria-activedescendant 讓螢幕閱讀器能正確朗讀。這部分原範例並未涵蓋,但對可用性影響很大。
把資料流與安全邊界處理對了,這個功能其實並不難——難的是那些容易被省略的細節。