多选下拉框

简介

多选下拉框标签（multiSelect）可创建多选下拉框，通过以下三种方式设置选项列表数据来源：
▶ enumSource：定义枚举数据源，值为枚举类全名。
▶ listSource：定义java.util.List类型数据源，值为com.kingdee.bos.webframework.util.SelectItem泛型的List对象。
▶ urlSource：定义url数据源，指定访问地址，返回json字符串。

▶ 下拉框过滤标签（selectfilter）用于对选项的过滤，可快速定位到目标选项

使用方法

2.1 JS动态创建 EAS8.0+

var options = {id:"select_id",name:"select_name",option:"select_option",enumSource:[{'alias':'未提交','value':0},
{'alias':'未审批','value':1}, 
{'alias':'审批中','value':2}, 
{'alias':'审批通过','value':3}, 
{'alias':'审批不通过','value':4}]};
var dom = waf.createDOM("mselect", options);
waf.appendDOM(waf("body"), dom);
waf.initComponent("mselect", options, dom);

2.2 通用DOM创建 EAS8.0+

<select id='ccc'></select>

<!--DOM创建好之后，使用js初始化控件-->
var options = {name:"select_name",option:"select_option",enumSource:[{'alias':'未提交','value':0},
{'alias':'未审批','value':1}, 
{'alias':'审批中','value':2}, 
{'alias':'审批通过','value':3}, 
{'alias':'审批不通过','value':4}]};
waf("#ccc").wafMultiSelect(options);

2.3 方法&事件使用 EAS8.0+

//调用方法
waf("#id").wafMultiSelect('method', parameter...);
//eg:获取和设置值
waf("#id").wafMultiSelect("getValue");
waf("#id").wafMultiSelect("setValue","1");
//eg:更改事件
waf("#id").wafMultiSelect("option","onchange",fn);

属性说明

id string 缺省值: null 不可以在运行期改变 EAS8.0+

定义下拉框控件的id

name string 缺省值: null 不可以在运行期改变 EAS8.0+

定义下拉框的名称

enumSource json 缺省值: null EAS8.0+

定义枚举数据源，值为枚举类全名。在运行期变换数据源时，传递的值为json对象，格式如：简单格式：[{‘alias’:’未提交’,’value’:0},{‘alias’:’未审批’,’value’:1},{‘alias’:’审批中’,’value’:2},{‘alias’:’审批通过’,’value’:3},{‘alias’:’审批不通过’,’value’:4}]或者带分组格式：[{‘childs’:[{‘alias’:’人民币’,’value’:’chinesermb’},{‘alias’:’日元’,’value’:’japaneseyen’},{‘alias’:’韩元’,’value’:’koreanwon’}],’groupAlias’:’亚洲货币’},{‘childs’:[{‘alias’:’美国美元’,’value’:’dollar’},{‘alias’:’加拿大加元’,’value’:’CanadianDollar’}],’groupAlias’:’美洲货币’}]

listSource enum 缺省值: null 不可以在运行期改变 EAS8.0+

定义List类型数据源，接收的值为com.kingdee.bos.webframework.util.SelectItem泛型的List对象

urlSource string 缺省值: null EAS8.0+

定义url数据源，指定访问地址，返回json字符串。在后台可构造元素为com.kingdee.bos.webframework.util.SelectItem类型的List对象，并调用com.kingdee.bos.webframework.util.TagUtil.toJson(ListdataList)获得json字符串后输出

value Object 缺省值: null EAS8.0+

定义下拉框的初始选项。单选情况下，默认选项为第一项，可接收的值类型有以下几种：简单数据类型、com.kingdee.util.enums.Enum或其子类、com.kingdee.bos.webframework.util.SelectItem；多选情况下，无默认选项，可接收的值类型有以下几种：字符串（以’,”相隔）、java.util.List或者java.util.List。指定后将选中与该值对应的选项

disabled Boolean 缺省值: false EAS8.0+

定义下拉框为禁用状态

hidden Boolean 缺省值: false EAS8.0+

定义下拉框的隐藏状态，默认值为false

height String 缺省值: null EAS8.0+

定义下拉框的高度，值可以是整数、百分比或字符串

listHeight Integer，String 缺省值: null EAS8.0+

定义下拉框选项列表的高度。若取值为’auto”，则会根据列表选项个数计算列表高度

width String 缺省值: null EAS8.0+

定义下拉框的宽度，值可以是整数、百分比或字符串

noneSelectedText String 缺省值: 请选择 EAS8.0+

定义未选择选项时下拉框中的文字，默认值为’请选择’。当标签属性header=’true’且multiple为true或multiple时，可以在运行期改变noneSelectedText的值

tabindex Integer 缺省值: 0 EAS8.0+

规定按下tab键时文本框控件获得焦点的顺序，默认值为0

style String 缺省值: null EAS8.0+

定义下拉框的样式

tagClass String 缺省值: null EAS8.0+

定义下拉框的样式类，可以添加一个或多个

formatter Function 缺省值: null EAS8.0+

定义下拉框的格式化函数，此函数接收到两个参数，分别为value和label，对应某个选项的值和标题

value string 缺省值: null 不可以在运行期改变 EAS8.0+

定义送往服务器的选项值 <?

selected Boolean 缺省值: false 不可以在运行期改变 EAS8.0+

规定当下拉框select未设置value初始值时，该选项（在首次显示在列表中时）表现为选中状态

label string 缺省值: null 不可以在运行期改变 EAS8.0+

定义选项组名称描述

label string 缺省值: 过滤：不可以在运行期改变 EAS8.0+

下拉框选项列表过滤框左侧文字，默认为’过滤：’

width String 缺省值: null 不可以在运行期改变 EAS8.0+

下拉框选项列表过滤框宽度

placeholder string 缺省值: 输入关键字过滤不可以在运行期改变 EAS8.0+

下拉框选项列表过滤框提示文字，默认为’输入关键字过滤”

autoReset Boolean 缺省值: false 不可以在运行期改变 EAS8.0+

定义下拉框选项列表关闭时是否重置过滤框中查询字符，默认值为false

header Boolean 缺省值: false 不可以在运行期改变 EAS8.0+

定义下拉框选项列表关闭时是否重置过滤框中查询字符，默认值为false

checkAllText Boolean 缺省值: false 不可以在运行期改变 EAS8.0+

全选option中的文本内容，默认值为false

uncheckAllText Boolean 缺省值: false 不可以在运行期改变 EAS8.0+

不全选option中的文本内容，默认值为false ?>

selectedList Boolean 缺省值: false 不可以在运行期改变 EAS8.0+

选中的下拉框的内容，默认值为false

方法说明

enable 参数: (无) 返回值: (无) EAS8.0+

启用下拉框控件 [参考样例]

参数说明: 无
返回值说明: 无

disable 参数: (无) 返回值: (无) EAS8.0+

用下拉框控件 [参考样例]

参数说明: 无
返回值说明: 无

isOpen 参数: (无) 返回值类型: (Boolean) EAS8.0+

判断该控件选项列表是否打开 [参考样例]

参数说明: 无
返回值说明: 无

open 参数: (无) 返回值: (无) EAS8.0+

打开下拉框选项列表 [参考样例]

参数说明: 无
返回值说明: 无

close 参数: (无) 返回值: (无) EAS8.0+

关闭下拉框选项列表 [参考样例]

参数说明: 无
返回值说明: 无

option 参数: (property[,value]) 返回值类型: (Object) EAS8.0+

获得或设置下拉框某属性的值，当value参数存在时，设置控件的property属性值，且无返回值，否则返回控件的property属性值 [参考样例]

参数说明:
property-必要参数
[value]下拉框的属性value-可选参数，下拉框的属性值
返回值说明: 无

option 参数: (options) 返回值: (无) EAS8.0+

对下拉框多个属性进行一次性设置 [参考样例]

参数说明:
options-形式如{property:value[,property1:value1,…]}的json对象，用来描述下拉框的属性和相应的值
返回值说明: 无

refresh 参数: (无) 返回值: (无) EAS8.0+

重新加载下拉框选项列表。如果通过AJAX或者DOM动态增加或删除下拉框中的选项，可以调用refresh方法使下拉框选项列表随之变化 [参考样例]

参数说明: 无
返回值说明: 无

getValueObject 参数: (无) 返回值类型: (对象或对象数组) EAS8.0+

获得选中对象或对象数组，每一个对象格式如：{value:”1”,alias:”未提交”} [参考样例]

参数说明: 无
返回值说明: 无

getValue 参数: (无) 返回值类型: (String) EAS8.0+

获得选中对象的值，多选时值之间以逗号相隔 [参考样例]

参数说明: 无
返回值说明: 无

getSelectedAlias 参数: (无) 返回值类型: (String) EAS8.0+

获得选中对象的别名，多选时值之间以逗号相隔 [参考样例]

参数说明: 无
返回值说明: 无

setValue 参数: (value) 返回值: (无) EAS8.0+

设置下拉框中选中的选项，本例设置下拉框的选项值为“未提交” [参考样例]

参数说明：
value-与选项对应的value值，多选时值之间以逗号相隔
返回值说明: 无

getIndex 参数: (value) 返回值类型: (number) EAS8.0+

获得值为value的选项的索引位置，从0开始计数。本例中获得value值为“0”的选项的索引。 [参考样例]

参数说明：
value-必要参数，欲获得索引位置的选项的值
返回值说明: 无

addOption 参数: (obj[,index]) 返回值: (无) EAS8.0+

在下拉框列表中的第index个位置上，动态增加选项 [参考样例]

参数说明：
obj-必要参数，json对象或json对象数组，json对象的格式如{value:”option7”,alias:”港币”}
[index]-可选参数，下拉列表选项所添加的位置，从0开始计数。当该参数不存在或者参数值不小于下拉列表选项总数时，将选项默认添加至下拉列表末端
返回值说明: 无

removeOption 参数: ([index]) 返回值: (无) EAS8.0+

动态移除下拉框列表中的第index个位置上的选项 [参考样例]

参数说明：
[index]-可选参数，欲移除的下拉列表选项所在的位置，从0开始计数。当该参数不存在时，清空所有下拉列表选项
返回值说明: 无

getAllOptions 参数: (无) 返回值类型: (Object) EAS8.0+

获得下拉框所有选项的json对象数组 [参考样例]

参数说明: 无
返回值说明: 无

checkAll 参数: (无) 返回值: (无) EAS8.0+

获得下拉框所有选项[参考样例]

参数说明: 无
返回值说明: 无

uncheckAll 参数: (无) 返回值: (无) EAS8.0+

不获得下拉框所有选项 [参考样例]

参数说明: 无
返回值说明: 无

getChecked 参数: (无) 返回值类型: (Object) EAS8.0+

获得选中下拉框所有选项的json对象数组 [参考样例]

参数说明: 无
返回值说明: 无

事件说明

beforeopen 参数: (无) EAS8.0+

在选项列表打开前触发该事件，可通过返回false来阻止选项列表打开 [参考样例]

参数说明: 无

onopen 参数: (无) EAS8.0+

打开下拉框列表时触发onopen事件 [参考样例]

参数说明: 无

beforeclose 参数: (无) EAS8.0+

在选项列表关闭前触发beforeclose事件，可通过返回false来阻止选项列表关闭 [参考样例]

参数说明: 无

onclose 参数: (无) EAS8.0+

在关闭下拉框列表时触发onclose该事件 [参考样例]

参数说明: 无

onclick 参数: (event,ui) EAS8.0+

当下拉框列表中选项被点击时触发onclick事件。 [参考样例]

参数说明：
event-原始事件对象
ui-ui.value为所点击的选项的值，ui.text为所点击的选项的标签文字，ui.checked表示所点击选项是否被选中

onchange 参数: (event,ui) EAS8.0+

当选择的选项发生变化时，触发onchange事件。 [参考样例]

参数说明：
event-原始事件对象
ui-ui.previous为改变前的选项的值，ui.current为改变后的选项的值