搜索框在輸入時即時給出候選列表,是使用者早已习惯的交互。jQuery UI 的 autocomplete 組件把這件事封裝得很完整,本文的重點在於兩個實務難點:如何接自己的接口,以及如何讓動態添加的輸入框也具備提示能力。
把初始化邏輯收進一個函數並接收元素參數,這樣無論是頁面已有的輸入框還是後續動態插入的,都能一行調用掛上提示。
// 自動完成提示
function tip(obj) {
$(obj).autocomplete({
minLength: 0,
source: function (request, response) {
$.ajax({
url: "HotList.php?act=title",
type: 'get',
dataType: "json",
data: request,
success: function (dataObj) {
// request 對象只有一個 term 屬性,對應用戶輸入的文本
// response 是一個函數:自行取數後把 JSON 交給它,
// autocomplete 便會根據數據渲染候選列表
response(dataObj);
},
error: function (XMLHttpRequest, textStatus, errorThrown) {
// 失敗時可在此做降級處理,例如 response([])
}
});
},
focus: function (event, ui) {
$(obj).val(ui.item.title);
return false;
},
select: function (event, ui) {
$(obj).val(ui.item.title);
$(obj).prev().val(ui.item.id); // 把 id 寫進相鄰的隱藏域
return false;
}
})
.data("ui-autocomplete")._renderItem = function (ul, item) {
return $("<li>")
.append("<a>" + item.id + "<br>" + item.title + "</a>")
.appendTo(ul);
};
}
幾處值得說明:source 寫成函數是為了能自己發請求,若數據是本地數組,直接寫 source: ["蘋果","香蕉"] 即可。focus 與 select 中 return false 是為了阻止組件默認把值填成 title 之後再覆蓋一次,避免閃動。_renderItem 自定義了每條候選的 HTML 結構,這是控制下拉樣式的入口。
<div class="control-group">
<label class="control-label">*相關推薦</label>
<div class="controls">
<?php foreach ($listOne['recommend_title'] as $k => $v) { ?>
<div>
<input type="hidden" name="tuijian_id[]"
value="<?php echo $listOne['title_id'][$k]; ?>" />
<input type="text" name="tuijian[]" class="show_goods"
onkeyup="tip(this)" value="<?php echo $v; ?>" />
<span class="btn" onclick="del(this);">刪除</span>
</div>
<?php } ?>
<span class="btn" id="add" onclick="add(this);">添加</span>
<script>
// 添加推薦節點:新插入的輸入框同樣掛上 tip
function add(obj) {
var str = "<div>"
+ "<input type='hidden' name='tuijian_id[]' />"
+ "<input type='text' class='show_goods' name='tuijian[]' onkeyup='tip(this)' />"
+ "<span class='btn' onclick='del(this);'>刪除</span>"
+ "</div>";
$(obj).before(str);
}
// 刪除當前推薦節點
function del(obj) {
if ($(".show_goods").length <= 3) {
alert('最少需要三個推薦標題');
return false;
}
$(obj).parent().remove();
}
</script>
</div>
</div>
這裡的關鍵設計是:新增節點的模板字符串裡同樣寫了 onkeyup="tip(this)",所以不需要額外做事件委託,新輸入框自動具備提示能力。相對於依賴事件委託,這種寫法更直白,代價是 HTML 中混入了一些行為邏輯。
加防抖。使用者快速敲字時會連發多個請求,在 source 中加入 200 到 300 毫秒的延遲能顯著降低服務端壓力。
接口失敗要有降級。error 分支目前是空的,建議調用 response([]),否則組件可能停留在加載狀態。
注意 XSS。候選內容若來自用戶生成數據,_renderItem 中直接拼接 HTML 會有注入風險,應改用 $("<li>").text(item.title) 這類安全寫法。
新版 API 有變動。jQuery UI 1.9 之後,取得組件實例的寫法改為 $(obj).autocomplete("instance"),老項目中的 .data("ui-autocomplete") 已不推薦使用。