Checkbox与RadioGroup的使用方法

rel="File-List" href="file:///C:%5CDOCUME%7E1%5CADMINI%7E1%5CLOCALS%7E1%5CTemp%5Cmsohtml1%5C01%5Cclip_filelist.xml">

没错！是Checkbox与RadioGroup而不是Checkbox与Radio。

Ex提供的Checkbox与Radio，在控件同名成组时，例如将性别的男与女两个Radio控件都使用sex作为名称时，findField方法只能获取第一个控件，setValue也只能设置第一个控件，这样就造成了如果要使用Form的Load方式加载编辑数据或者用SetValues加载编辑数据时出现问题。要解决这个问题，第一种方法是定义名称不同的控件；第二种方法是控件名称相同，在加载编辑数据时手动处理控件状态。第一种方法对Checkbox问题不是太大，因为各Checkbox之间没关联。但是Radio就不同，彼此间是关联，例如性别选择男了，那女须为未选择状态，这个在名称相同时，会自动处理，不需要写多余代码，但是名称不同，则要通过check事件去修改其它控件的状态。第二种方法存在问题是，Checkbox同名，要获取第一个控件后的控件比较困难，要处理也困难。基于以上原因，笔者习惯的做法是Checkbox使用不同名的定义方法，Radio使用Ext官方论坛用户vtswingkid开发的Ext.ux.RadioGroup扩展代替。

Ext.ux.RadioGroup在的下载地址是：http://extjs.com/forum/showthread.php?t=23250。

Checkbox在定义时必须使用ColumnLayout，第一列的控件有标签，后续列的控件则隐藏标签。不然，会很难实现习惯的Checkbox对齐方式。Ext.ux.RadioGroup在扩展的同时已经处理好对齐问题了，所以不必象Checkbox那样使用ColumnLayout。

Checkbox的主要配置参数请看表1。

表1 Checkbox主要配置参数
配置参数	描述
boxLabel	在复选框后显示的文本
checked	值为true表示初始状态为已选，false则表示未选，默认值是false
disabled	值为true表示初始状态为禁止使用，false则表示可以使用，默认值是false
fieldLabel	控件标签
hideLabel	值为true表示隐藏标签，false则显示，默认值是true
labelSeparator	标签分隔符
inputValue	Checkbox的实际提交值。如果不设置该值，无论value设置为什么值，Checkbox提交值都为“on”，
msgTarget	错误信息显示位置，默认值是qtip，详细信息请看Form校验与错误信息显示一节
name	控件名称
readOnly	值为true则表示初始状态为只读，false则表示可写，默认值为false，不推荐使用该值设置只读，因为设置后不允许再修改，如果要设置只读属性，请参考本书第7章编辑控件只读插件一节
tabIndex	键盘tab键移动时的索引

 

Ext.ux.RadioGroup的主要配置参数请看表2。

表2 Ext.ux.RadioGroup主要配置参数
配置参数	描述
fieldLabel	控件标签
name	控件名称
horizontal	值为true则表示Radio选项水平排列，false则表示垂直排列，默认值为false
radios	Radio选项组成的数组
radios子项配置：value	Radio选项正式值
radios子项配置：checked	值为true则表示已选，false则表示未选，默认值是false
radios子项配置：boxLabel	在单选框后显示的文本

Checkbox与RadioGroup的使用方法请看例子：

第4章 Checkbox与RadioGroup例子                           执行操作：

 

例子的运行结果如图 1 。


rel="File-List" href="file:///C:%5CDOCUME%7E1%5CADMINI%7E1%5CLOCALS%7E1%5CTemp%5Cmsohtml1%5C01%5Cclip_filelist.xml">

从图中可以看到定义了2组Checkbox与一组RadioGroup，并设置了相应的测试按钮，在执行操作多行文本框内可以了解各按钮执行的操作以及一些结果。

第1组定义了“role1”、“role2”和“role3”3个不同名称的Checkbox，可顺利通过findField方法找到控件，然后通过setValue方法设置复选框的状态。控制复选框的状态有多种值选择，设置为已选的值有true、on或value配置参数设置的值，但是不能使用inputValue配置参数设置的值，设置为未选的值有false、off或空。

第2组定义了3个名称相同的Checkbox，通过findField(“role”)按钮可测试通过findField方法找到的控件是那一个，其结果如下：

执行：var obj=frm.form.findField('role')

obj.inputValue：系统管理员

从结果中可以了解到它查找出来的不是数组，只是第1个Checkbox。

再单击两个setValue按钮可以了解到通过findField方法找到控件后再使用setValue方法只能设置第1个Checkbox的状态，因为findField方法找到的是第1个Checkbox。

看看RadioGroup的定义方法：

{xtype:'ux-radiogroup',                                                                            fieldLabel:'性别',                                                                            name:'sex',                                                                            horizontal:true,                                                                            radios:[{                                                                                     value:'男',                                                                                     checked:true,                                                                                     boxLabel:'男'                                                                            }, {                                                                                     value:'女',                                                                                     boxLabel:'女'                                                                            }]                                                                  }

相当简单。RadioGroup的标签为性别，名称为sex，单选按钮水平排列，radios里定义了两个单选按钮，第1个的值为男，初始状态为已选，显示文本为男，第2个的值是女，显示文本为女。通过两个setValue按钮，可测试setValue方法将value配置的值作为参数传递就可以设置那个单选按钮为已选状态了。

FormPanel里还有两个按钮用来测试Form的setValues方法与getValues方法。

先单击setValues按钮，该按钮执行了以下语句：

frm.form.setValues({role1:true,role:true,sex:'男'})

 

“{role1:true,role:true,sex:'男'}”的意思就是对应名称为role1的控件的设置为已选，就是第1组Checkbox的系统管理员为选中状态。名称为role的因为同名，只能设置第1个Checkbox的状态，所以也是系统管理员为选中状态。名称为sex的值设置为男，表示性别的男为选中状态。

在第1组Checkbox中选择系统管理员和普通用户，第2组Checkbox中选择经理与普通用户，在性别中选择女，然后单击form.getValues()按钮，会获得如下结果：

执行：frm.form.getValues() 结果：{"role1":"on","role3":"on","role":["经理","普通用户"],"sex":"女"}

从结果中可以了解到，第 1 组中被选中的 role1 和 role3 两个控件的值为 on ，因为 role2 没有被选中，所以没有值；第 2 组 role 因为设置了 inputValue ，所以返回的是经理与普通用户两个值，；第 3 组 sex 则返回了选择值的“女”。以上的结果也是 Form 提交的值，可以单击保存按钮通过 Firebug 测试一下，测试结果如图 2 。