Bootstrap 是當下流行的前端 UI 元件庫之一,能快速構建美觀統一的頁面。它內建了「帶下拉選單的文字框」元件,但相比 WinForm 的 DropDownList 控制項,還缺少幾個實用功能。本文示範如何自己封裝一個 jQuery 外掛來補齊這些不足。

1、點擊選單項後,文字自動填入文字框;
2、提供回呼函式取得相關資料;
3、文字框不可編輯,只能透過選單變更內容;
4、可設定下拉選單最大高度,項目過多時出現捲軸。
InputName:文字框的 name/id,預設 "Q"。
ButtonText:按鈕文字,預設 "示例"。
ReadOnly:是否唯讀,預設 true。
MaxHeight:選單最大高度,預設 -1(不限制)。
onSelect:選擇項目時呼叫的函式,預設 $.noop()。
Items:選單項目集合,每項含 ItemText、ItemData、Selected。
Sections:選單分組集合,優先級高於 Items。
由於基於 jQuery,需將此程式碼置於 jQuery 引用之下:
<script>
(function($) {
jQuery.fn.DropDownList = function(options) {
var defaults = {
InputName: "Q",
ButtonText: "示例",
ReadOnly: true,
MaxHeight: -1,
onSelect: $.noop(),
};
var options = $.extend(defaults, options);
return this.each(function() {
var o = options;
var Obj = $(this);
var S = "<div class='input-group'>";
S += "<input type='text' class='form-control' name='" + o.InputName + "' id='" + o.InputName + "' />";
S += "<div class='input-group-btn'>";
S += "<button type='button' class='btn btn-default dropdown-toggle' data-toggle='dropdown'>" + o.ButtonText + "<span class='caret'></span></button>";
S += "<ul class='dropdown-menu dropdown-menu-right' role='menu'>";
if (o.Sections !== undefined) {
$.each(o.Sections, function(n, value) {
if (n > 0) { S += "<li class='divider'></li>"; }
if (value.ItemHeader !== undefined) {
S += "<li class='dropdown-header'>" + value.ItemHeader + "</li>";
}
CreateItem(value);
});
} else {
CreateItem(o);
}
var SelText = "", SelData = "";
function CreateItem(Items) {
$.each(Items.Items, function(n, Item) {
if (Item.ItemData === undefined) { Item.ItemData = Item.ItemText; }
S += "<li><a href='#' ItemData='" + Item.ItemData + "'>" + Item.ItemText + "</a></li>";
if (Item.Selected == true) { SelText = Item.ItemText; SelData = Item.ItemData; }
});
}
S += "</ul></div></div>";
Obj.html(S);
var Input = Obj.find("input");
if (SelText != "") { SetData(SelText, SelData); }
Obj.find("a").bind("click", function(e) {
SetData($(this).html(), $(this).attr("ItemData"));
});
if (o.ReadOnly == true) {
Input.bind("cut copy paste keydown", function(e) { e.preventDefault(); });
}
if (o.MaxHeight > 0) {
var UL = Obj.find("ul");
if (UL.height() > o.MaxHeight) {
UL.css({ 'height': o.MaxHeight, 'overflow': 'auto' });
}
}
function SetData(Text, Data) {
Input.val(Text);
if (o.onSelect) { o.onSelect(o.InputName, Data); }
}
});
};
})(jQuery);
</script>
以 Items 屬性實作單一分組的選單:
$("#DropDownList").DropDownList({
InputName: "Q",
ButtonName: "參考",
onSelect: function(I, Data) { alert(I + ":" + Data); },
Items: [
{ ItemText: "示例1", ItemData: "Demo1", Selected: true },
{ ItemText: "示例2", ItemData: "Demo2" },
{ ItemText: "示例3", ItemData: "Demo3" }
]
});

以 Sections 屬性實作帶分組標題與分隔線的選單:
$("#DropDownList").DropDownList({
InputName: "Q",
ButtonText: "參考",
onSelect: function(I, Data) { alert(I + ":" + Data); },
Sections: [
{ ItemHeader: "全部", Items: [ { ItemText: "全部", ItemData: "All" } ] },
{ Items: [
{ ItemText: "示例1", ItemData: "Demo1", Selected: true },
{ ItemText: "示例2" }
] }
]
});

設定 MaxHeight 屬性以支援大量項目(例如全國行政區選擇)時,選單過長會自動出現垂直捲軸。
以上就是打造以 Bootstrap 為基礎的 DropDownList jQuery 外掛的完整做法,希望對你有所幫助。