DIV CSS 佈局教程網

用 jQuery UI autocomplete 做出百度式搜索提示(支援動態增刪輸入框)
編輯:JQuery入門技巧     

搜索框在輸入時即時給出候選列表,是使用者早已习惯的交互。jQuery UI 的 autocomplete 組件把這件事封裝得很完整,本文的重點在於兩個實務難點:如何接自己的接口,以及如何讓動態添加的輸入框也具備提示能力。

JS 部分:封裝成可復用的函數

把初始化邏輯收進一個函數並接收元素參數,這樣無論是頁面已有的輸入框還是後續動態插入的,都能一行調用掛上提示。

// 自動完成提示
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 結構,這是控制下拉樣式的入口。

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") 已不推薦使用。

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