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 プラグイン その他の拡張