jQuery EasyUI 表單插件 - Combo 組合

jQuery EasyUI 插件 jQuery EasyUI 插件

擴展自 $.fn.validatebox.defaults。通過 $.fn.combo.defaults 重寫默認的 defaults。

組合（combo）是在 html 頁面上顯示一個可編輯的文本框和下拉麵板。它是用於創建其他複雜的組合組件（比如：組合框 combobox、組合樹 combotree、組合網格 combogrid，等等）的基礎組件。

依賴

  • validatebox
  • panel

用法

組合（combo）可以使用 javascript 從 <select> 或 <input> 元素進行創建。請注意，從標記創建組合（combo）是無效的。

<input id="cc" value="001">

$('#cc').combo({
    required:true,
    multiple:true
});

屬性

該屬性擴展自驗證框（validatebox），下麵是為組合（combo）添加的屬性。

名稱 類型 描述 默認值
width number 組件的寬度。 auto
height number 組件的高度。該屬性自版本 1.3.2 起可用。 22
panelWidth number 下拉麵板的寬度。 null
panelHeight number 下拉麵板的高度。 200
multiple boolean 定義是否支持多選。 false
selectOnNavigation boolean 定義當通過鍵盤導航專案時是否選擇專案。該屬性自版本 1.3.3 起可用。 true
separator string 多選時文本的分隔符號。 ,
editable boolean 定義用戶是否可以往文本域中直接輸入文字。 true
disabled boolean 定義是否禁用文本域。 false
readonly boolean 定義組件是否只讀。該屬性自版本 1.3.3 起可用。 false
hasDownArrow boolean 定義是否顯示向下箭頭的按鈕。 true
value string 默認值。
delay number 從最後一個鍵的輸入事件起，延遲進行搜索。 200
keyHandler object 當用戶按鍵後調用的函數。默認的 keyHandler 定義如下： 
keyHandler: {
    up: function(){},
    down: function(){},
    enter: function(){},
    query: function(q){}
}

事件

名稱 參數 描述
onShowPanel none 當下拉麵板顯示的時候觸發。
onHidePanel none 當下拉麵板隱藏的時候觸發。
onChange newValue, oldValue 當文本域的值改變的時候觸發。

方法

該方法擴展自驗證框（validatebox），下麵是為組合（combo）添加的方法。

名稱 參數 描述
options none 返回選項（options）對象。
panel none 返回下拉麵板對象。
textbox none 返回文本框對象。
destroy none 銷毀組件。
resize width 調整組件的寬度。
showPanel none 顯示下拉麵板。
hidePanel none 隱藏下拉麵板。
disable none 禁用組件。
enable none 啟用組件。
readonly mode 啟用/禁用只讀模式。該方法自版本 1.3.3 起可用。
用法實例： 
$('#cc').combo('readonly');        // enable readonly mode
$('#cc').combo('readonly', true);    // enable readonly mode
$('#cc').combo('readonly', false);    // disable readonly mode
validate none 驗證輸入的值。
isValid none 返回驗證結果。
clear none 清除組件的值。
reset none 重置組件的值。該方法自版本 1.3.2 起可用。
getText none 獲取輸入的文本。
setText none 設置文本值。
getValues none 獲取組件的值的數組。
setValues none 設置組件的值的數組。
getValue none 獲取組件的值。
setValue none 設置組件的值。
jQuery EasyUI 插件 jQuery EasyUI 插件