单选框 RadioGroup

Constructor
Implements: Widget
Tutorials: 控件对象使用快速入门

可设置的属性

Name	Type	Default	Description
`name`	String		控件的名字，唯一标志
`title`	String		控件title
`hidden`	Boolean		隐藏
`validates`	Validators		校验器
`value`	String		值
`readonly`	Boolean		只读
`selections`	Array		选项
`textField`	String	`text`	待选值中显示值的field
`valueField`	String	`value`	待选中真实值的field
`url`	String		远程加载待选值的URL JSON数据格式举例：示例如下
`realText`	Boolean		设置值时的text将被忽略，根据value从待选值取
`hoverTip`	String		悬停提示

JSON数据格式举例：

[
	{"text" : "男" , "value" : "1" },
	{"text" : "女" , "value" : "2" }
]

可获取的属性

Name	Type	Default	Description
`name`	String		控件的名字，唯一标志
`title`	String		控件title
`hidden`	Boolean		隐藏
`validates`	Validators		校验器
`value`	String		值
`readonly`	Boolean		只读
`selections`	Array		选项
`textField`	String	`text`	待选值中显示值的field
`valueField`	String	`value`	待选中真实值的field
`url`	String		远程加载待选值的URL
`realText`	Boolean		设置值时的text将被忽略，根据value从待选值取
`hoverTip`	String		悬停提示

方法

validate

Description： 执行校验

Name	Type	Description
调用参数		无
返回值	Boolean	校验是否成功

调用举例：

var widget = vjsp.Parser.getWidgetByName('radioGroup');
var result = widget.doMethod('validate');

intoView

Description： 把控件移动到页面可视范围

调用举例：

var widget = vjsp.Parser.getWidgetByName('radioGroup');
widget.doMethod('intoView');

addValidator

Description： 增加校验器

调用参数

Name	Type	Description
`validator`	Object	校验器对象

返回值：无

调用举例：

var widget = vjsp.Parser.getWidgetByName('radioGroup');
//通过api增加必填校验器
widget.doMethod('addValidator' , vjsp.Validators.get(
    'required',
    [],
    widgetLang.validate.required
));

removeValidator

Description： 删除校验器

调用参数

Name	Type	Description
`name`	String	校验器名称

返回值：无

调用举例：

var widget = vjsp.Parser.getWidgetByName('radioGroup');
//删除必填校验
widget.doMethod('removeValidator' , 'required');

showValidateMsg

Description： 显示校验信息,多用于自定义校验器的开发

调用参数

Name	Type	Description
`msg`	String	提示信息

返回值：无

调用举例：

var widget = vjsp.Parser.getWidgetByName('radioGroup');
//提示不能为空
widget.doMethod('showValidateMsg' , '控件不能为空');

hideValidateMsg

Description： 隐藏校验信息，多用于自定义校验器的开发

调用举例：

var widget = vjsp.Parser.getWidgetByName('radioGroup');
widget.doMethod('hideValidateMsg');

disSelections

Description： 禁用部分待选项此禁用为用户操作上的禁用，即不能通过鼠标点击改变

调用参数

Name	Type	Attributes	Default	Description
`val`	Any｜Array.<Any>			值/索引（或者值/索引的数组）,如果是值则是任意类型（通常为String）,如果是索引则必须是Number类型,索引从0开始
`type`	String	`optional`	`value`	type 取值为 `value` 和 `index` 当为`value`时则val参数为值,通过值比对禁用当为`index`时则val参数为索引,通过索引比对来禁用

返回值：无

调用举例：

//禁用值为'testVal1' , 'textVal2'的待选项
var widget = vjsp.Parser.getWidgetByName('radioGroup');
widget.doMethod('disSelections' , ['testVal1' , 'textVal2']);

//禁用值为第2,3,4个待选项
var widget = vjsp.Parser.getWidgetByName('radioGroup');
widget.doMethod('disSelections' , [2,3,4] , 'index');

事件

change

Description： 值改变 绑定举例：

var widget = vjsp.Parser.getWidgetByName('radioGroup');
widget.on('change' , function(){
    //控制台输出新值
    console.info('new value' , this.get('value'));
});

click

Description： 单击

回调函数参数

Name	Type	Description
`e`	Object	jQuery事件对象

绑定举例：

var widget = vjsp.Parser.getWidgetByName('radioGroup');
widget.on('click' , function(e){
    vjsp.alert('click event');
});

dblclick

Description： 双击

回调函数参数

Name	Type	Description
`e`	Object	jQuery事件对象

绑定举例：

var widget = vjsp.Parser.getWidgetByName('radioGroup');
widget.on('dblclick' , function(e){
    vjsp.alert('dblclick event');
});

contextmenu

Description： 弹出上下文菜单

回调函数参数

Name	Type	Description
`e`	Object	jQuery事件对象

绑定举例：

var widget = vjsp.Parser.getWidgetByName('radioGroup');
widget.on('contextmenu' , function(e){
    vjsp.alert('contextmenu event');
});

mousedown

Description： 鼠标按下

回调函数参数

Name	Type	Description
`e`	Object	jQuery事件对象

绑定举例：

var widget = vjsp.Parser.getWidgetByName('radioGroup');
widget.on('mousedown' , function(e){
    vjsp.alert('mousedown event');
});

mouseup

Description： 鼠标弹起

回调函数参数

Name	Type	Description
`e`	Object	jQuery事件对象

绑定举例：

var widget = vjsp.Parser.getWidgetByName('radioGroup');
widget.on('mouseup' , function(e){
    vjsp.alert('mouseup event');
});

mousemove

Description： 鼠标移动

回调函数参数

Name	Type	Description
`e`	Object	jQuery事件对象

绑定举例：

var widget = vjsp.Parser.getWidgetByName('radioGroup');
widget.on('mousemove' , function(e){
    vjsp.alert('mousemove event');
});

mouseover

Description： 鼠标移动控件上

回调函数参数

Name	Type	Description
`e`	Object	jQuery事件对象

绑定举例：

var widget = vjsp.Parser.getWidgetByName('radioGroup');
widget.on('mouseover' , function(e){
    vjsp.alert('mouseover event');
});

mouseout

Description： 鼠标离开

回调函数参数

Name	Type	Description
`e`	Object	jQuery事件对象

绑定举例：

var widget = vjsp.Parser.getWidgetByName('radioGroup');
widget.on('mouseout' , function(e){
    vjsp.alert('mouseout event');
});

mouseenter

Description： 鼠标移入

回调函数参数

Name	Type	Description
`e`	Object	jQuery事件对象

绑定举例：

var widget = vjsp.Parser.getWidgetByName('radioGroup');
widget.on('mouseenter' , function(e){
    vjsp.alert('mouseenter event');
});

mouseleave

Description： 鼠标移出

回调函数参数

Name	Type	Description
`e`	Object	jQuery事件对象

绑定举例：

var widget = vjsp.Parser.getWidgetByName('radioGroup');
widget.on('mouseleave' , function(e){
    vjsp.alert('mouseleave event');
});

hidden

Description： 隐藏事件（隐藏显示触发回调参数为隐藏状态）

回调函数参数

Name	Type	Description
`hiddenState`	Boolean	隐藏状态`true`为隐藏、`false`为取消隐藏

绑定举例：

var widget = vjsp.Parser.getWidgetByName('radioGroup');
widget.on('hidden' , function(hiddenState){
    if(hiddenState){
        vjsp.alert('控件被隐藏');
    }else{
        vjsp.alert('控件取消隐藏');
    }
});

readonly

Description： 只读事件（只读状态改变触发回调参数为只读状态）

回调函数参数

Name	Type	Description
`readonlyState`	Boolean	只读状态 `true`为只读、`false`为取消只读

绑定举例：

var widget = vjsp.Parser.getWidgetByName('radioGroup');
widget.on('readonly' , function(readonlyState){
    if(readonlyState){
        vjsp.alert('控件只读');
    }else{
        vjsp.alert('控件取消只读');
    }
});

# 单选框 RadioGroup

# 可设置的属性

# 可获取的属性

# 方法

# validate

# intoView

# addValidator

# removeValidator

# showValidateMsg

# hideValidateMsg

# disSelections

# 事件

# change

# click

# dblclick

# contextmenu

# mousedown

# mouseup

# mousemove

# mouseover

# mouseout

# mouseenter

# mouseleave

# hidden

# readonly

单选框 RadioGroup

可设置的属性

可获取的属性

方法

validate

intoView

addValidator

removeValidator

showValidateMsg

hideValidateMsg

disSelections

事件

change

click

dblclick

contextmenu

mousedown

mouseup

mousemove

mouseover

mouseout

mouseenter

mouseleave

hidden

readonly