自動完成(autocomplete)幾乎是搜尋框的標配。老牌外掛 jquery.autocomplete 支持兩種資料來源:前端陣列與後端 URL。本文用兩個小例子各跑一次,並記錄一個容易忽略的樣式陷阱。
下載 jquery.autocomplete.js 與 jquery.autocomplete.css,連同 jQuery 一起引入。
<script src="Scripts/jquery-1.4.1-vsdoc.js" type="text/javascript"></script>
<script src="Scripts/jquery.autocomplete.js" type="text/javascript"></script>
<link href="Styles/jquery.autocomplete.css" type="text/css" />
<script language="javascript" type="text/javascript">
// 方式一:直接由陣列取得
$(document).ready((function () {
var data = ["河北省", "河南省", "山東", "北京", "天津"];
$("#txtProvince").autocomplete(data);
// 方式二:由伺服器端取得
$("#txtUser").autocomplete("GetUserName.aspx");
}));
</script>
<div>
省份:<input id="txtProvince" type="text" />
</div>
<div>
用戶名:<input id="txtUser" type="text" /></div>
外掛預設以 query string q 傳送輸入框的關鍵字,回應時以換行分隔每一筆候選:
protected void Page_Load(object sender, EventArgs e)
{
// 默認傳入的鍵值為 q
if (Request.QueryString["q"] != null)
{
string key = Request.Params["q"].ToString();
string result = "";
db db = new db();
string sql = "select UserName from Users where UserName like '" + key + "%'";
SqlDataReader dr = db.GetReader(sql);
while (dr.Read())
{
result += dr["UserName"].ToString() + "\n";
}
if (result == "")
result = "not exists";
Response.Write(result);
}
}
這裡要注意:字串拼接 SQL 存在 SQL 注入風險,正式環境請改用參數化查詢(SqlParameter)。此外,回應前應明確設定 Response.ContentEncoding 為 UTF-8,否則中文容易出現亂碼。
功能跑通後發現候選列表長得很難看,怎麼看都像沒套上 CSS。折騰了半天毫無頭緒,隔天早上才恍然大悟——<link> 標籤漏寫了 rel="stylesheet"。瀏覽器不會報錯,只是靜靜地忽視這行標籤。
這也提醒我們:外掛「跑得起來」和「長得對」是兩件事,引入階段就要把 CSS 路徑與屬性一次檢查清楚。一個簡單的示例到此完成,繼續往下學。