多选下拉框

简介

多选下拉框标签(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为改变后的选项的值

样例集合

  1. 多选下拉框属性
  2. 多选下拉框方法
  3. 多选下拉框事件
  4. 动态化