DIV CSS 佈局教程網

jQuery UI Autocomplete 自動完成功能實踐分享
編輯:JQuery特效代碼     

jQuery UI 的 Autocomplete 元件能輕鬆實現輸入框的自動完成提示。本文系統性地介紹它支援的資料來源、常用參數、使用方法與事件。

支援的資料來源

主要支援字串 Array 與 JSON 兩種格式。普通陣列:

["cnblogs","博客園","囧月"]

JSON 格式的陣列則要求有 label、value 屬性:

[{label: "博客園", value: "cnblogs"}, {label: "囧月", value: "囧月"}]

其中 label 用於顯示在彈出菜單,value 則是選中後賦給文本框的值。若只指定其中一個屬性,則兩者相同。需注意從伺服器輸出的 JSON key 必須用雙引號,否則可能出現 parsererror:

[{"label": "博客園", "value": "cnblogs"}, {"label": "囧月", "value": "囧月"}]

主要參數

  • source:資料來源,可為 String、Array、Function
  • minLength:輸入達到指定長度時才激活
  • autoFocus:彈出時自動選中第一項
  • delay:延遲多少毫秒激活

使用方法

AJAX 請求

$("#autocomp").autocomplete({
source: "remote.ashx",
minLength: 2
});

伺服器端接收時,注意預設傳遞的參數名稱為 term:

public void ProcessRequest(HttpContext context)
{
// 查詢的參數名稱默認為term
string query = context.Request.QueryString["term"];
context.Response.ContentType = "text/javascript";
//輸出字符串數組 或者 JSON 數組
context.Response.Write("[{\"label\":\"博客園\",\"value\":\"cnblogs\"},{\"label\":\"囧月\",\"value\":\"囧月\"}]");
}

本地 Array/JSON 陣列

var availableTags = ["C#", "C++", "Java", "JavaScript", "ASP", "ASP.NET", "JSP", "PHP", "Python", "Ruby"];
$("#local1").autocomplete({
source: availableTags
});

Callback Function 方式

透過指定 source 為自訂函式來實現自訂資料的獲取,函式有 request、response 兩個參數:

var hosts = ["gmail.com", "live.com", "hotmail.com", "yahoo.com", "cnblogs.com"];
$("#email1").autocomplete({
autoFocus: true,
source: function(request, response) {
var term = request.term,
ix = term.indexOf("@"),
name = term,
host = "",
result = [];
result.push(term);
if (ix > -1) {
name = term.slice(0, ix);
host = term.slice(ix + 1);
}
if (name) {
var findedHosts = (host ? $.grep(hosts, function(value) {
return value.indexOf(host) > -1;
}) : hosts),
findedResults = $.map(findedHosts, function(value) {
return name + "@" + value;
});
result = result.concat($.makeArray(findedResults));
}
response(result);//呈現結果
}
});

主要事件

Autocomplete 提供 create、search、open、focus、select、close、change 等事件,可用於在各階段進行額外控制。這些事件可透過參數或 bind 綁定,用 bind 時事件名稱為「autocomplete」加上事件名,如 select 對應 autocompleteselect。

多個值的 Autocomplete

若需要輸入多個值(如 javascript,c#,asp.net),需綁定額外事件處理:在 focus 事件返回 false 避免值被取代、在 select 事件中組合多個值、在 keydown 事件做處理:

// 按逗號分隔多個值
function split(val) {
return val.split(/,\s*/);
}
function extractLast(term) {
return split(term).pop();
}
var options = {
focus: function() {
return false;
},
select: function(event, ui) {
var terms = split(this.value);
terms.pop();
terms.push(ui.item.value);
terms.push("");
this.value = terms.join(", ");
return false;
}
};
$("#local3").bind("keydown", function(event) {
if (event.keyCode === $.ui.keyCode.TAB && $(this).data("autocomplete").menu.active) {
event.preventDefault();
}
}).autocomplete($.extend(options, {
minLength: 2,
source: function(request, response) {
response($.ui.autocomplete.filter(availableTags, extractLast(request.term)));
}
}));

更多資料可參考 jQuery UI Autocomplete 官方演示。

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