Keel v0.5.1 English GitHub

RadioGroup

在线示例:这是真实的 Keel 程序编译成 WebAssembly,可以直接操作。首次加载约 10 MB。全屏打开
示例代码Go · 可复制

这是上方组件库展示案例的完整源码。examples/components/radio_group.go

在脚手架项目中复用组件构造和 Render 写法;示例的 registerSection 与共享辅助函数由组件库提供。

package main

import (
	"github.com/dyike/keel/ui/core"
	"github.com/dyike/keel/ui/el"
	"github.com/dyike/keel/ui/kit"
	"github.com/dyike/keel/ui/theme"
)

func init() {
	registerSection("radio_group", "inputs", func() core.Widget {
		pay := kit.RadioGroup(demoText("Payment method", "付款方式"), demoText("Bank transfer", "转账"), demoText("Check", "支票"), demoText("Cash", "现金"))
		pay.SetValue(demoText("Bank transfer", "转账"))
		pay.SetOptionDisabled(demoText("Check", "支票"), true)
		plans := kit.RadioGroup(demoText("Plan", "套餐"), demoText("Basic", "基础"), demoText("Pro", "专业")).Size(28).TextSize(20)
		for _, plan := range []struct{ name, description string }{{demoText("Basic", "基础"), demoText("For personal use", "适合个人使用")}, {demoText("Pro", "专业"), demoText("Includes team collaboration", "支持团队协作")}} {
			plans.Content(plan.name, el.ViewFunc(func(cx *el.Context) el.Element {
				return el.Div().Gap(theme.SpaceXs).Child(el.Text(plan.name).Bold(),
					el.Text(plan.description).TextSize(theme.TextSm).TextColor(theme.Muted))
			}))
		}
		size := kit.RadioGroup(demoText("Size", "尺寸"), "S", "M", "L").Horizontal().Size(14).TextSize(12).ItemSize("M", 18, 14).ItemSize("L", 28, 20)
		return el.Embed(el.ViewFunc(func(cx *el.Context) el.Element {
			return el.Div().P(24).Gap(16).Items(el.Start).Child(pay.Render(cx), size.Render(cx),
				el.Div().Role("radiogroup").Name(demoText("Plan", "套餐")).Gap(12).Child(
					el.Div().P(12).Child(plans.Item(demoText("Basic", "基础")).Render(cx)),
					el.Div().P(12).Child(plans.Item(demoText("Pro", "专业")).Render(cx))))
		}))
	})
}

从几个选项中选一个。

pay := kit.RadioGroup("付款方式", "转账", "支票", "现金").OnChange(func(s string) { … })
size := kit.RadioGroup("尺寸", "S", "M", "L").Horizontal()
  • 键盘行为和原生单选组一致:Tab 进入组时落在当前选中项(没有选中或选中项被禁用时落在第一项可用项),方向键移动并选中,首尾循环。默认整个组只占一个 Tab 停靠点;显式 ItemTab 可覆盖。
  • SetOptionDisabled(value, bool) 禁用单项,保留已有选择;方向键跳过禁用项,Home / End 到首末可用项。全禁用时不占 Tab 停靠点。
  • Item(value) 返回可独立渲染的选项,适用于卡片布局;同一组的所有 Item 共享选择、键盘顺序和禁用状态。每个值在一帧内只渲染一次;外层自行声明 radiogroup 角色和名称。未渲染或祖先禁用的项不会成为方向键目标。
  • Size(dp) 设置组内圆点直径,默认 18dp,正值限制在 12–64dp;TextSize(sp) 设置选项继承字号,正值限制在 8–128sp。两者传 0 恢复默认,负值/非有限值忽略;独立 Item 使用相同配置。
  • Content(value, view) 替换对应选项的可见标签,可组合标题、说明、图标等展示内容。原选项字符串仍是值和可访问名称;内容不应包含按钮或输入框。传 nil 恢复文字,未知选项忽略;重排保留内容,移除选项会清理内容。内容每帧渲染,显式字号优先于组的继承字号。
  • Options() 返回副本;传入选项也会复制,空值和重复值被移除。重排保留选项身份。
  • Value() 返回选中项,没有选中时为空;SetValue 不触发回调;SetOptions 替换选项,原选择不在新选项里时清空;SetDisabled。

Agent:组的角色是 radiogroup,每个选项是 radio,checked 表示是否选中。

验证:go run ./examples/components -section radio_group,加 -theme dark 检查深色。

富标签示例:

plans := kit.RadioGroup("套餐", "基础", "专业").Size(28).TextSize(20)
plans.ItemSize("基础", 18, 14)
plans.Content("专业", el.ViewFunc(func(cx *el.Context) el.Element {
    return el.Div().Child(el.Text("专业版").Bold(),
        el.Text("支持团队协作").TextSize(theme.TextSm).TextColor(theme.Muted))
}))

默认使用组内单个 Tab 停靠点。TabStop(false) 或 TabIndex(-1) 可跳过整组,仍允许鼠标和方向键选择;非负 TabIndex 按升序排列,同值按树顺序,范围限单 el root。ItemTab(value, stop, index) 可覆盖单项配置,该项显式参与停靠判断,不再受默认单停靠点限制;ClearItemTab(value) 恢复组配置。逐项覆盖重排保留,删除清理,未知选项忽略。禁用项始终不能停靠;Tab 移动本身不改变选中值。

ItemSize(value, dp, sp) 可逐项覆盖圆点和字号,各参数为 0 时继承组配置;ItemSize(value, 0, 0) 清除覆盖。正值沿用组的上下限,未知选项或任一负值/非有限值忽略整个调用。重排保留覆盖,删除选项会清理。独立 Item 同样生效。

单个、位置自由的单选按钮见 Radio。