jQueryのEasyUIフォームプラグイン - コンボボックスコンボボックス
$ .fn.combo.defaultsから延長しました。 $ .fn.combobox.defaultsして、デフォルトのデフォルトを上書きします。
コンボボックス(コンボボックス)は、テキストボックスを表示し、ドロップダウンリストを編集することができ、ユーザは、ドロップダウンリストから1つまたは複数の値を選択することができます。 ユーザーが直接、リストの一番上にテキストを入力するか、リストから1つ以上の既存の値を選択することができます。
頼ります
- コンボ
使用法
事前定義された構造(コンボボックス)で、<select>要素からのコンボボックスを作成します。
<選択のid = "CC"クラス= "easyui-コンボボックス"名前= "DEPT"スタイル= "幅:200pxの;"> <オプション値= "AA"> aitem1 </オプション> <オプション> bitem2 </オプション> <オプション> bitem3 </オプション> <オプション> ditem4 </オプション> <オプション> eitem5 </オプション> </選択>
<入力>タグからコンボボックス(コンボボックス)を作成します。
<入力されたID = "CC"クラス= "easyui-コンボボックス"名前= "DEPT" データ・オプション= "valueField:「ID」、テキストフィールド:「テキスト」は、url: 'get_data.php'">
コンボボックス(コンボボックス)を作成するにはJavaScriptを使用してください。
<入力されたID = "CC"名前= "DEPT"値= "AA">
$( '#のC-C')。コンボボックス({ URL: 'combobox_data.json」、 valueField:「ID」、 テキストフィールド:「テキスト」 });
2依存コンボボックス(コンボボックス)を作成します。
<入力されたID = "CC1"クラス= "easyui-コンボボックス「データ・オプション=" valueField:「ID」、 テキストフィールド:「テキスト」、 URL: 'get_data1.php」、 onSelect:機能(REC){ var urlは= '?get_data2.phpのid =' + rec.id。 。$( '#CC2を')コンボボックス( 'リロード'、URL); } "> <入力されたID = "CC2"クラス= "easyui-コンボボックス「データ・オプション=" valueField:「ID」、テキストフィールド: 'テキスト' ">
JSONデータ形式の例:
[{ 「ID」:1、 "テキスト": "テキスト1" }、{ "ID":2、 "テキスト": "テキスト2" }、{ 「ID」:3、 "テキスト": "テキスト3」、 「選択」:真 }、{ 「ID」:4、 "テキスト": "text4" }、{ 「ID」:5、 "テキスト": "text5" }]
プロパティ
プロパティが組み合わせ(コンボ)から延び、以下は、コンボボックス(コンボボックス)プロパティを追加です。
名称 | 类型 | 描述 | 默认值 |
---|---|---|---|
valueField | string | 绑定到该组合框(ComboBox)的 value 上的基础数据的名称。 | value |
textField | string | 绑定到该组合框(ComboBox)的 text 上的基础数据的名称。 | text |
groupField | string | 指示要被分组的字段。该属性自版本 1.3.4 起可用。 | null |
groupFormatter | function(group) | 返回要显示在分组项目上的分组文本。该属性自版本 1.3.4 起可用。 代码实例: $('#cc').combobox({ groupFormatter: function(group){ return '<span style="color:red">' + group + '</span>'; } }); |
|
mode | string | 定义在文本改变时如何加载列表数据。如果组合框(combobox)从服务器加载就设置为 'remote'。当设置为 'remote' 模式时,用户输入的值将会被作为名为 'q' 的 http 请求参数发送到服务器,以获取新的数据。 | local |
url | string | 从远程加载列表数据的 URL 。 | null |
method | string | 用来检索数据的 http 方法。 | post |
data | array | 被加载的列表数据。 代码实例: <input class="easyui-combobox" data-options=" valueField: 'label', textField: 'value', data: [{ label: 'java', value: 'Java' },{ label: 'perl', value: 'Perl' },{ label: 'ruby', value: 'Ruby' }]" /> |
null |
filter | function | 定义当 'mode' 设置为 'local' 时如何过滤本地数据。该函数有两个参数: q:用户输入的文本。 row:列表中的行数据。 返回 true 则允许显示该行。 代码实例: $('#cc').combobox({ filter: function(q, row){ var opts = $(this).combobox('options'); return row[opts.textField].indexOf(q) == 0; } }); |
|
formatter | function | 定义如何呈现行。该函数有一个参数:row。 代码实例: $('#cc').combobox({ formatter: function(row){ var opts = $(this).combobox('options'); return row[opts.textField]; } }); |
|
loader | function(param,success,error) | 定义如何从远程服务器加载数据。返回 false 则取消该动作。该函数有下列参数: param:要传到远程服务器的参数对象。 success(data):当获取数据成功时将被调用的回调函数。 error():当获取数据失败时将被调用的回调函数。 |
json loader |
loadFilter | function(data) | 返回要显示的过滤数据。该属性自版本 1.3.3 起可用。 |
イベント
組み合わせ(コンボ)から拡大したイベントは、以下のイベントを追加するためのコンボボックス(コンボボックス)です。
名称 | 参数 | 描述 |
---|---|---|
onBeforeLoad | param | 在请求加载数据之前触发,返回 false 则取消加载动作。 代码实例: // change the http request parameters before load data from server $('#cc').combobox({ onBeforeLoad: function(param){ param.id = 2; param.language = 'js'; } }); |
onLoadSuccess | none | 当远程数据加载成功时触发。 |
onLoadError | none | 当远程数据加载失败时触发。 |
onSelect | record | 当用户选择一个列表项时触发。 |
onUnselect | record | 当用户取消选择一个列表项时触发。 |
ウェイ
方法は組み合わせ(コンボ)から延びて、次のメソッドを追加したり、上書きするコンボボックス(コンボボックス)です。
名称 | 参数 | 描述 |
---|---|---|
options | none | 返回选项(options)对象。 |
getData | none | 返回加载的数据。 |
loadData | data | 加载本地列表数据。 |
reload | url | 请求远程的列表数据。传 'url' 参数来重写原始的 URL 值。 代码实例: $('#cc').combobox('reload'); // reload list data using old URL $('#cc').combobox('reload','get_data.php'); // reload list data using new URL |
setValues | values | 设置组合框(combobox)值的数组。 代码实例: $('#cc').combobox('setValues', ['001','002']); |
setValue | value | 设置组合框(combobox)的值。 代码实例: $('#cc').combobox('setValue', '001'); |
clear | none | 清除组合框(combobox)的值。 |
select | value | 选择指定的选项。 |
unselect | value | 取消选择指定的选项。 |
jQueryのEasyUIプラグイン