ToggleGroup

Since 2.2.1

ToggleGroupElement 是一个布局容器，可自动为添加到其中的所有 Toggle 子元素管理 Toggle.ToggleGroup。你无需手动调用 toggle.setToggleGroup(group)——当子元素被添加或移除时，该元素会自动处理。

UIElement 上记录的所有内容（布局、样式、事件、数据绑定等）在此同样适用。

---

用法

JavaKotlinKubeJS

var group = new ToggleGroupElement();
group.getToggleGroup().setAllowEmpty(false);

group.addChild(new Toggle().setText("Option A", true).setOn(true));
group.addChild(new Toggle().setText("Option B", true));
group.addChild(new Toggle().setText("Option C", true));

// Retrieve the currently-active toggle
Toggle active = group.getToggleGroup().getCurrentToggle();

val group = ToggleGroupElement()

group.addChild(toggle({ text("Option A"); isOn = true }) { })
group.addChild(toggle({ text("Option B") }) { })
group.addChild(toggle({ text("Option C") }) { })

let group = new ToggleGroupElement();
group.addChild(new Toggle().setText("Option A", true).setOn(true));
group.addChild(new Toggle().setText("Option B", true));

---

XML

<toggle-group>
    <toggle text="Option A" is-on="true"/>
    <toggle text="Option B"/>
    <toggle text="Option C"/>
</toggle-group>

在 XML 编辑器中，只能添加 Toggle（及其子类）作为子元素。其他元素类型会被拒绝。

---

Toggle Group 行为

属性	默认值	描述
allowEmpty	false	当为 false 时，始终至少有一个开关处于激活状态。当为 true 时，所有开关都可以关闭。
currentToggle	可为空	当前选中的 Toggle，或当 allowEmpty = true 且没有选中项时为 null。

JavaKotlin

var group = new ToggleGroupElement();
group.getToggleGroup().setAllowEmpty(true);

Toggle current = group.getToggleGroup().getCurrentToggle(); // may be null

val groupEl = ToggleGroupElement()
groupEl.toggleGroup.allowEmpty = true

val current: Toggle? = groupEl.toggleGroup.currentToggle

---

字段

名称	类型	访问修饰符	描述
toggleGroup	Toggle.ToggleGroup	public final	共享的 ToggleGroup 实例。

---

方法

继承 UIElement 的所有方法。

当你调用 addChild / removeChild 时，ToggleGroupElement 会重写这些方法，自动将任何 Toggle 子元素注册到内部的 ToggleGroup 或从中注销。