egret-docs-master/extension/EUI/controls/radioButton
guofei 4fe0162b34 fist commit 2024-06-19 13:32:32 +08:00
..
5601563aebfa4.png fist commit 2024-06-19 13:32:32 +08:00
README.md fist commit 2024-06-19 13:32:32 +08:00

README.md

单选按钮和复选框的区别在于单选按钮不会单独使用而是若干个单选按钮结成一组来使用并且选择是排斥性的如果选择了A那B,C,D则会自动切换到非选中状态。如果在界面上不止一组单选按钮那么结组使用就更有必要了并且必须保证不同的单选按钮组之间互不干扰。 创建单选按钮的方式如下:

var rdb:eui.RadioButton = new eui.RadioButton();
rdb.label = "Select 1";
rdb.value =1;
this.addChild(rdb);
注意上面的`value`属性,它可以设置附加的数据,类型不限,可以是数字,字符串,甚至是一个自定义类型的对象。
当用户选择了某一个单选按钮,就可以直接获取其附加的数据。

当然,一个单选按钮没有实际意义,创建多个单选按钮并结组的代码示例如下:

方式1使用groupName

private initRadioButton():void {
    var rdb: eui.RadioButton = new eui.RadioButton();
    rdb.label = "Select 1";
    rdb.value = 145;
    rdb.groupName = "G1";
    rdb.addEventListener(eui.UIEvent.CHANGE,
        this.radioChangeHandler,
        this);
    this.addChild(rdb);
    var rdb2: eui.RadioButton = new eui.RadioButton();
    rdb2.y = 30;
    rdb2.label = "Select 2";
    rdb2.value = 272;
    rdb2.selected = true;//默认选项
    rdb2.groupName = "G1";
    rdb2.addEventListener(eui.UIEvent.CHANGE,
        this.radioChangeHandler,
        this);
    this.addChild(rdb2);
}
private radioChangeHandler(evt:eui.UIEvent):void {
    egret.log(evt.target.value);
}

得到的效果:

这样的实现方式较为简单,但缺点是,如果想监视选项的变化,需要在每个单选按钮上都添加egret.Event.CHANGE事件侦听。同样,如果想得到最终选定的那个值,就必须循环判断,找到selected = true的那个单选按钮,取它的值。所以更推荐使用第二种方案:

方式2使用RadioButtonGroup

创建一个egret.gui.RadioButtonGroup的实例,并设置到每个单选按钮的group属性上。这样的好处在于,只需要处理RadioButtonGroup实例上的事件侦听,就能捕获数值的变化,要取得最终选择的值,从RadioButtonGroup实例上直接获取即可。示例代码:

private initRadioButtonWithGroup():void {
    var radioGroup: eui.RadioButtonGroup = new eui.RadioButtonGroup();
    radioGroup.addEventListener(eui.UIEvent.CHANGE, this.radioChangeHandler, this);
    var rdb: eui.RadioButton = new eui.RadioButton();
    rdb.label = "Select 1";
    rdb.value = 145;
    rdb.group = radioGroup;
    this.addChild(rdb);
    var rdb2: eui.RadioButton = new eui.RadioButton();
    rdb2.y = 30;
    rdb2.label = "Select 2";
    rdb2.value = 272;
    rdb2.selected = true;//默认选项
    rdb2.group = radioGroup;
    this.addChild(rdb2);
}
private radioChangeHandler(evt:eui.UIEvent):void {
    var radioGroup: eui.RadioButtonGroup = evt.target;
    console.log(radioGroup.selectedValue);
}

同前面一节一样,这里使用:

egret create HelloEUI --type eui

创建示例项目的默认皮肤。可以在示例项目的eui_skins文件夹下找到默认皮肤的 exml 文件。