DIV CSS 佈局教程網

打造以 Bootstrap 為基礎的 DropDownList jQuery 外掛
編輯:關於JavaScript     

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 外掛的完整做法,希望對你有所幫助。

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