DIV CSS 佈局教程網

jQuery 仿百度標籤輸入插件(含效果圖與完整程式碼)
編輯:JQuery特效代碼     

這是一個仿百度經驗的標籤輸入元件:輸入框可連續輸入多個標籤,以逗號、分號、空白或 Enter 分隔;下方提供「記憶標籤」與「熱門標籤」供點擊快速填入;並可限制標籤數量與每個標籤的字數。

效果預覽

一、呼叫方式

<link href="/Styles/tagsinput.css" rel="stylesheet" type="text/css" />
<script src="/Scripts/jquery-1.4.1.min.js" type="text/javascript"></script>
<script src="/Scripts/jquery.tagsinput.js" type="text/javascript"></script>
<script type="text/javascript">
$(function () {
    $("#txtTags").TagsInput({
        usedTags: "css|js|jquery|html|C#|.net|web",   // 記憶標籤,以 | 分隔
        hotTags:  "hotTag1|hotTag2|hotTag3|hotTag4",   // 熱門標籤
        tagNum:   10,                                  // 最多幾個標籤
        maxWords: 10                                   // 每個標籤最多幾個漢字
    });
});
</script>

二、HTML

<input type="text" value="逗號|分號|空格|Tab|回車鍵" name="txtTags" id="txtTags" />

三、樣式 tagsinput.css

.clearfix:after {
    clear: both;
    content: " ";
    display: block;
    height: 0;
}
.tags-wrapper {
    width: 500px;
    position: relative;
}
#addTagWrap {
    background: none repeat scroll 0 0 #FFFFFF;
    border: 1px solid #D9D9D9;
    padding: 0 5px;
}
#addTagWrap .inner-tag-wrapper, .layer-tag-name {
    background: none repeat scroll 0 0 #40A8CD;
    border-radius: 3px;
    color: #FFFFFF;
    float: left;
    height: 26px;
    line-height: 26px;
    margin: 4px 6px 0 0;
    padding: 0 5px 0 10px;
    white-space: nowrap;
}
#addTagWrap .inner-tag-close {
    color: #A0D4E6;
    font-family: sans-serif;
    margin-left: 4px;
    text-decoration: none;
}
#tagInput {
    background: none repeat scroll 0 0 #FFFFFF;
    border: medium none;
    margin: 0;
    height: 24px;
    line-height: 24px;
    overflow: hidden;
    padding: 5px;
    width: 215px;
}
#tagInput:focus { outline: none; }

.layer-tags-wrapper {
    border: 1px solid #DADADA;
    border-top: 0;
    overflow: auto;
    position: absolute;
    left: 0;
    right: 0;
    display: none;
    background: none repeat scroll 0 0 #FFFFFF;
}
.layer-tags-wrapper .layer-tags-box { padding: 0 5px; }
.layer-tags-wrapper .layer-tags-left {
    float: left;
    text-align: center;
    padding-right: 5px;
    margin-top: 4px;
    height: 26px;
    line-height: 26px;
}
.layer-tags-wrapper .layer-tags-right { overflow: auto; }
.layer-tags-wrapper .layer-tag-name {
    padding-right: 10px;
    text-decoration: none;
}
.layer-tags-foot {
    height: 30px;
    line-height: 30px;
    color: #999999;
    padding-left: 5px;
}
.layer-tags-foot-top {
    margin-top: 5px;
    border-top: 1px dotted #C9C9C9;
}
.message-box {
    background: none repeat scroll 0 0 rgba(0, 0, 0, 0.35);
    color: #FFFFFF;
    width: 300px;
    min-height: 50px;
    line-height: 50px;
    top: 50%;
    left: 50%;
    margin-top: -50px;    /* 高度的一半 */
    margin-left: -150px;  /* 寬度的一半 */
    position: fixed;
    z-index: 999;
    text-align: center;
    border-radius: 5px;
}

四、主程式 jquery.tagsinput.js

/* 仿百度標籤輸入 v0.1
 * @name jquery.tagsinput.js
 */
(function ($) {
    $.fn.TagsInput = function (options) {
        // 預設參數
        var defaults = { usedTags: "", hotTags: "", tagNum: 0, maxWords: 0 };
        var opts = $.extend(defaults, options);
        var $this = $(this);
        $this.hide();                       // 原輸入框隱藏,改用自製 UI

        var arrayTags, strHtml;
        strHtml = "<div class=\"tags-wrapper clearfix\">";
        strHtml += "<div id=\"addTagWrap\"><div class=\"added-tags-wrapper\"></div>";
        strHtml += "<input id=\"tagInput\" type=\"text\" placeholder=\"添加標簽,以逗號、分號或空格隔開\" autocomplete=\"off\">";
        strHtml += "</div><div class=\"layer-tags-wrapper\">";

        // 記憶標籤區
        if (opts.usedTags != "") {
            strHtml += "<div class=\"clearfix layer-tags-box\"><div class=\"layer-tags-left\">記憶標簽</div><div class=\"layer-tags-right\">";
            arrayTags = opts.usedTags.split('|');
            for (var i = 0; i < arrayTags.length; i++) {
                strHtml += "<a class=\"layer-tag-name\" href=\"javascript:;\">" + arrayTags[i] + "</a>";
            }
            strHtml += "</div></div>";
        }

        // 熱門標籤區
        if (opts.hotTags != "") {
            strHtml += "<div class=\"clearfix layer-tags-box\"><div class=\"layer-tags-left\">熱門標簽</div><div class=\"layer-tags-right\">";
            arrayTags = opts.hotTags.split('|');
            for (var i = 0; i < arrayTags.length; i++) {
                strHtml += "<a class=\"layer-tag-name\" href=\"javascript:;\">" + arrayTags[i] + "</a>";
            }
            strHtml += "</div></div>";
        }

        // 提示文字
        if (opts.tagNum != 0 && opts.maxWords != 0) {
            strHtml += "<div class=\"layer-tags-foot clearfix\">最多可添加" + opts.tagNum + "個標簽,每個標簽不超過" + opts.maxWords + "個漢字</div>";
        } else if (opts.tagNum != 0) {
            strHtml += "<div class=\"layer-tags-foot clearfix\">最多可添加" + opts.tagNum + "個標簽</div>";
        } else if (opts.maxWords != 0) {
            strHtml += "<div class=\"layer-tags-foot clearfix\">每個標簽不超過" + opts.maxWords + "個漢字</div>";
        } else {
            strHtml += "<div class=\"layer-tags-foot clearfix\">標簽個數最好少於10個,每個標簽最好不超過10個漢字</div>";
        }
        strHtml += "</div></div>";
        $(strHtml).insertAfter($this);

        if ($(".layer-tag-name").length > 0) {
            $(".layer-tags-foot").addClass("layer-tags-foot-top");
        }

        // 把原輸入框既有的值轉成標籤
        var inputTags = $this.val();
        arrayTags = inputTags.split('|');
        for (var i = 0; i < arrayTags.length; i++) {
            addTag(arrayTags[i]);
        }

        // 點擊建議標籤即可加入
        $(".layer-tag-name").each(function () {
            $(this).click(function () { addTag($(this).text()); });
        });

        // 鍵盤操作
        $("#tagInput")
            .keydown(function (e) {
                var keyCode = e.which || e.keyCode;
                if (keyCode == 13 || keyCode == 32 || keyCode == 9) {   // Enter、空白、Tab
                    if (addTag($(this).val())) { $(this).val(""); }
                    return false;
                }
            })
            .keyup(function (e) {
                var keyCode = e.which || e.keyCode;
                if (keyCode == 188 || keyCode == 59) {                  // 逗號、分號
                    if (addTag($(this).val())) { $(this).val(""); }
                    return false;
                }
            })
            .click(function () { $(".layer-tags-wrapper").show(); })
            .blur(function () {
                if (addTag($(this).val())) { $(this).val(""); }
                return false;
            });

        $(".tags-wrapper").mouseleave(function () {
            $(".layer-tags-wrapper").hide();
        });

        // 加入一個標籤
        function addTag(obj) {
            obj = obj.replace(/[ |,|,|;|;]/g, "");      // 去掉分隔符與空白
            if (obj == "") { return false; }

            // 只統計漢字字數
            var num = 0;
            var arr = obj.match(/[^\x00-\xff]/g);
            if (arr != null) {
                num = arr.length;
                if (opts.maxWords > 0 && num > opts.maxWords) {
                    MessageBox("單個標簽最多" + opts.maxWords + "個漢字");
                    return false;
                }
            }

            var tags = $("#addTagWrap .inner-tag-name");
            var flag = true;
            var s = "";
            tags.each(function () {
                if ($(this).text() == obj) { flag = false; return false; }   // 已存在
                num++;
                s += $(this).text() + "|";
            });

            if (opts.tagNum > 0 && num >= opts.tagNum) {
                MessageBox("最多可添加" + opts.tagNum + "個標簽");
                return false;
            }

            if (flag) {
                $(".added-tags-wrapper").append(
                    "<div class=\"inner-tag-wrapper\"><span class=\"inner-tag-name\">" + obj +
                    "</span><a class=\"inner-tag-close\" title=\"刪除\" href=\"javascript:;\">×</a></div>");
                $(".added-tags-wrapper .inner-tag-close:last").click(function () {
                    $(this).parent().remove();
                });
                s += obj + "|";
                if (s.length > 0) {
                    s = s.substring(0, s.length - 1);
                    $this.val(s);        // 同步回原輸入框
                }
                return true;
            } else {
                MessageBox("該標簽已經存在");
                return false;
            }
        }

        // 輕量提示框
        function MessageBox(obj) {
            $("<div class=\"message-box\">" + obj + "</div>").appendTo("body");
            $(".message-box").delay(1000).fadeOut("slow", function () {
                $(this).remove();
            });
        }
    };
})(jQuery);

設計重點

隱藏原生輸入框,另建 UI。插件把原本的 input 隱藏起來,改渲染自製的標籤容器,並隨時把結果同步寫回原 input 的 value。這樣做的好處是後端不用改,照舊從表單讀 name="txtTags" 即可。

用 keydown 攔截 Enter、空白、Tab,用 keyup 攔截逗號與分號。分兩組是因為部分鍵盤配置下,某些符號在 keydown 階段還讀不到正確的值。

漢字計數用 /[^\x00-\xff]/g。這個正則比對「非單位元字元」,能過濾出中文,避免英文與符號佔用字數額度。

以 | 作為內部儲存分隔符。標籤串用 標籤1|標籤2|標籤3 的形式存在原 input 裡,後端 split 一次即可還原陣列。

這個版本可以改進的地方

XSS 風險。addTag 裡用字串拼接把 obj 直接塞進 HTML,如果使用者貼入 <img src=x onerror=alert(1)> 就會被執行。建元素時應改用 $("<span>").text(obj) 讓 jQuery 自動轉義,或至少在插入前做一次 HTML 編碼。

用固定 id 會限制只能有一個實例。#tagInput、#addTagWrap 都是寫死的 id,同一頁放兩個標籤欄位就會互相干擾。改成 class 或依 $this 的 uid 產生唯一 id 才能支援多實例。

删除標籤時沒有同步回原 input。點 × 只呼叫 $(this).parent().remove(),$this.val() 並未更新,導致後端收到的仍是含已刪標籤的字串。應該把「重新收集所有 inner-tag-name 並回寫」抽成一個 sync() 函式,在加入與刪除後都呼叫。

用 mouseleave 隱藏建議層體驗不佳。使用者把滑鼠移到面板上選標籤時,若中間路徑離開過容器就會瞬間關閉。改用點擊外部($(document).on('click', ...) 判斷 target)會更穩。』

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