Checkbox
示例代码Go · 可复制
这是上方组件库展示案例的完整源码。examples/components/checkbox.go
在脚手架项目中复用组件构造和 Render 写法;示例的 registerSection 与共享辅助函数由组件库提供。
package main
import (
"github.com/dyike/keel/ui/core"
"github.com/dyike/keel/ui/el"
"github.com/dyike/keel/ui/kit"
)
func init() {
registerSection("checkbox", "inputs", func() core.Widget {
all, a, b := kit.Checkbox(demoText("Select all", "全选"), false), kit.Checkbox(demoText("Order SO-1001", "订单 SO-1001"), true), kit.Checkbox(demoText("Order SO-1002", "订单 SO-1002"), false)
sync := func() {
n := 0
for _, c := range []*kit.CheckboxView{a, b} {
if c.Value() {
n++
}
}
all.SetValue(n == 2)
all.SetMixed(n == 1)
}
a.OnChange(func(bool) { sync() })
b.OnChange(func(bool) { sync() })
all.OnChange(func(on bool) { a.SetValue(on); b.SetValue(on) })
sync()
off := kit.Checkbox(demoText("Unavailable", "不可用"), true)
off.SetDisabled(true)
small := kit.Checkbox(demoText("Small", "小尺寸"), true).Size(14).TextSize(12)
large := kit.Checkbox(demoText("Large · Indeterminate", "大尺寸 · 半选"), false).Size(28).TextSize(20)
large.SetMixed(true)
return el.Embed(el.ViewFunc(func(cx *el.Context) el.Element {
return el.Div().P(24).Gap(10).Items(el.Start).Child(all.Render(cx), el.Div().Pl(24).Gap(8).Child(a.Render(cx), b.Render(cx)), off.Render(cx), small.Render(cx), large.Render(cx))
}))
})
}
带标签的复选框,点击、Space、Enter 都会切换。
agree := kit.Checkbox("同意条款", false).OnChange(func(on bool) { … })
all.SetMixed(true) // "全选"在部分选中时显示半选
Value()/SetValue(bool)读取或设置是否勾选,SetValue不触发回调,并会清除半选状态。SetMixed(true)显示半选,点击后变为勾选。SetDisabled(true)后不能操作,SetLabel修改文字。- 需要用户点"提交"才生效的选项用 Checkbox;立即生效的开关用 Switch。
Agent:角色 checkbox,checked 表示是否勾选;半选时 value 为 mixed。
验证:go run ./examples/components -section checkbox,加 -theme dark 检查深色。
Size(dp) 设置方框边长,正值限制在 12–64dp,0 恢复默认 18dp;勾号和半选横线同步缩放。TextSize(sp) 单独设置标签字号,正值限制在 8–128sp,0 恢复父元素字号。负数和非有限值忽略;修改外观不改变值、半选状态或现有焦点。
agree.Size(24).TextSize(18).TabIndex(2)
TabStop(false) 仅跳过 Tab 遍历,仍可鼠标和程序聚焦。TabIndex(n) 按升序遍历,相同值保持树顺序,负值跳过。复用 el 的单 root 规则,浮层内独立循环,不跨独立 Embed 或原生 Gio 控件排序。焦点轮廓仍沿标签和方框整行绘制。