单选按钮组

简介

单选按钮组（radioGroup）定义单选按钮组控件，允许用户选取组中的一个radio选项。其中name、items为必要属性。

使用方法

1. 静态框架使用方法`仅EAS7.5版本`

<wafctrl:radioGroup name="rg" items="com.kingdee.bos.wafctrl.demo.radio.InvoiceTypeEnum" id="rg">
</wafctrl:radioGroup>

2. JS动态创建`EAS8.0+`

var options = {id:"sex",name:"sex",items:[{"alias":"男","value":1},{"alias":"女","value":0}]};
var parentDom = waf("body");
var dom = waf.createDOM("radioGroup", options);
waf.appendDOM(parentDom, dom);
waf.initComponent("radioGroup", options, dom);

3. 通用DOM创建`EAS8.0+`

<!-- DOM -->
<div id="sex"></div>

//DOM创建好之后，使用js初始化控件
var options = {name:"sex",items:[{"alias":"男","value":1},{"alias":"女","value":0}]};
waf("#sex").wafRadioGroup(options);

4. 方法&事件使用`EAS7.5+`

//调用方法
waf("#id").wafRadioGroup("method", parameter...);
//eg:方法调用
waf("#id").wafRadioGroup("getValue");
waf("#id").wafRadioGroup("disable");
//eg:更改事件
waf("#id").wafRadioGroup("option","onchange",fn);

属性说明

id String 缺省值: null 不可以在运行期改变 EAS7.5+

定义单选按钮组的id

name String 缺省值: null 不可以在运行期改变 EAS7.5+

定义单选按钮组的名称

items Object 缺省值: null 不可以在运行期改变 EAS7.5+

定义单选按钮组的选项。接收的对象类型有两种：
（1）实现java.util.Collection接口的类的对象，以EL表达式传入
（2）String类型，继承com.kingdee.util.enums.Enum的类的全路径名不能通过option方法在运行期进行改变，但可通过调用setItems方法来完成操作

value Object 缺省值: null EAS7.5+

定义单选按钮组中值为value的radio为选中状态，可以接收EL表达式

vertical Boolean 缺省值: false 不可以在运行期改变 EAS7.5+

定义单选按钮组中radio的显示方式。当vertical为true时，将竖直显示。默认值为false

disabled Boolean 缺省值: false EAS7.5+

定义单选按钮组为禁用状态，默认值为false

hidden Boolean 缺省值: false EAS7.5+

定义单选按钮组的隐藏状态，默认值为false.

tabindex Integer 缺省值: 0 EAS7.5+

规定按下tab键时单选按钮组控件获得焦点的顺序，默认值为0

tagClass String 缺省值: null EAS7.5+

定义单选按钮组中radio的样式类

style String 缺省值: null EAS7.5+

定义单选按钮组中radio的样式

方法说明

option 参数: (property[,value]) 返回值类型: (任何类型) EAS7.5+

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

参数说明:
- property: 必要参数，单选按钮组的属性
- value: 可选参数，单选按钮组的属性值
返回值说明:
参数没有value时，返回值为相应属性的值，返回值类型为属性对应的类型；参数有value时此方法的作用是设置属性的值，没有返回值。

option 参数: (options) 返回值类型: (undefined) EAS7.5+

对控件多个属性进行一次性设置 [参考样例]

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

getValue 参数: (无) 返回值类型: (Object) EAS7.5+

获得选中的radio的值 [参考样例]

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

setValue 参数: (value) 返回值类型: (undefined) EAS7.5+

将值为value的单选按钮选中 [参考样例]

参数说明:
- value: 必填参数，欲选中的单选按钮的值
返回值说明: 无

setItems 参数: (items) 返回值类型: (undefined) EAS7.5+

重置单选按钮组的radio选项 [参考样例]

参数说明:
- items: 必填参数，json对象数组，格式如[{value:1’,alias:”男”},{value:’2’,alias:’女’}]
返回值说明: 无

addItem 参数: (item[,pos]) 返回值类型: (undefined) EAS7.5+

在单选按钮组中添加radio项 [参考样例]

参数说明:
- item: 必填参数，json对象，格式如{value:3’,alias:’库存组织’}
- pos: 可选参数，定义radio项的添加的位置，从0开始计数。当不指定时，将添加到单选按钮组组的末尾。
返回值说明: 无

removeItemByPosition 参数: (pos) 返回值类型: (undefined) EAS7.5+

移除单选按钮组中位置为pos的radio项 [参考样例]

参数说明:
- pos: 必填参数，定义要移除的radio项的位置，从0开始计数。
返回值说明: 无

removeItemByValue 参数: (value) 返回值类型: (undefined) EAS7.5+

移除单选按钮组值为value中的radio项 [参考样例]

参数说明:
- value: 必填参数，定义要移除的radio项的值
返回值说明: 无

disableItem 参数: (itemValue[,value]) 返回值类型: (undefined) EAS7.5+

对于单选按钮组中值为itemValue的radio项进行禁用或启用 [参考样例]

参数说明:
- itemValue: 必填参数，定义要操作的的radio项的值
- value: 可选参数，当value为true时，禁用itemValue指定的radio，当value为false，启用该radio。若不指定，默认为true，即禁用。
返回值说明: 无

hideItem 参数: (itemValue[,value]) 返回值类型: (undefined) EAS7.5+

对于单选按钮组中值为itemValue的radio项进行隐藏或显示。 [参考样例]

参数说明:
- itemValue: 必填参数，定义要操作的的radio项的值
- value: 可选参数，当value为true时，隐藏itemValue指定的radio，当value为false，显示该radio。若不指定，默认为true，即隐藏。
返回值说明: 无

事件说明

onclick 参数: (event,itemValue) 返回值类型: (undefined) EAS7.5+

定义单选按钮组中radio的点击事件。 [参考样例]

参数说明:
- event: 原始事件对象
- itemValue: 所点击的radio选项的值。

onchange 参数: (event,ui) 返回值类型: (Boolean) EAS7.5+

定义单选按钮组中点击项发生改变时的事件。 [参考样例]

参数说明:
- event: 所响应的事件
- ui: ui.previous为改变前选中的radio的值，ui.current为改变后选中的radio的值
返回值说明: 返回false时，事件被取消.