Keel v0.5.1 English GitHub

Checkbox

在线示例:这是真实的 Keel 程序编译成 WebAssembly,可以直接操作。首次加载约 10 MB。全屏打开
示例代码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 控件排序。焦点轮廓仍沿标签和方框整行绘制。