Keel v0.5.1 English GitHub

ToggleGroup

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

这是上方组件库展示案例的完整源码。examples/components/toggle_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"
)

func init() {
	registerSection("toggle_group", "general", func() core.Widget {
		align := kit.ToggleGroup(demoText("Align left", "左对齐"), demoText("Center", "居中"), demoText("Align right", "右对齐")).Variant(kit.ToggleOutline).Size(kit.ToggleSizeLarge).Segmented(true)
		align.SetValue(demoText("Center", "居中"))
		separated := kit.ToggleGroup(demoText("Day", "日"), demoText("Week", "周"), demoText("Month", "月")).Segmented(true).Gap(8).Variant(kit.ToggleOutline)
		separated.SetValue(demoText("Week", "周"))
		icons := kit.ToggleGroup(demoText("Star", "收藏"), demoText("Notifications", "通知"), demoText("Inbox", "收件箱")).Multiple().Segmented(true).Variant(kit.ToggleOutline).
			Item(demoText("Star", "收藏"), kit.Toggle("", false).Icon(kit.IconStar)).
			Item(demoText("Notifications", "通知"), kit.Toggle("", false).Icon(kit.IconBell)).
			Item(demoText("Inbox", "收件箱"), kit.Toggle(demoText("Inbox", "收件箱"), false).Icon(kit.IconInbox))
		icons.SetValue(demoText("Star", "收藏"))
		style := kit.ToggleGroup("B", "I", "U").Multiple().Variant(kit.ToggleGhost).Size(kit.ToggleSizeSmall)
		return el.Embed(el.ViewFunc(func(cx *el.Context) el.Element {
			return el.Div().P(24).Gap(12).Items(el.Start).Child(align.Render(cx), style.Render(cx), separated.Render(cx), icons.Render(cx))
		}))
	})
}

一排开关按钮。默认单选,Multiple() 后可多选。

align := kit.ToggleGroup("左对齐", "居中", "右对齐")
style := kit.ToggleGroup("B", "I", "U").Multiple().OnChange(func(on []string) { … })
  • 单选模式下,再点一次已按下的选项会取消选择。
  • Value() 按选项顺序返回已按下的选项(返回副本),SetValue(values...) 不触发回调;单选模式只保留第一个。SetDisabled。

Agent:容器角色 group,每个按钮是 toggle。

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

所有变体都无边框。ToggleGhost 和 ToggleOutline 未选中时背景透明,ToggleDefault 使用 Subtle 浅色填充;分段组的未选中项同样用 Subtle 填充,项之间留 1dp 间隙;选中项使用 Highlight。只有键盘或程序聚焦时显示内嵌焦点环。

Size(...) 接受 ToggleSizeXSmall、ToggleSizeSmall、ToggleSizeMedium、ToggleSizeLarge, 同步调整高度、字号、图标和水平留白,高度分别为 24/28/32/40dp,默认 Medium。运行中切换样式保留焦点与选中状态,不触发 OnChange。非法枚举值忽略。

Segmented(true) 将相邻按钮组成一组,默认用 1dp 背景间距分隔,只保留首尾外侧圆角,不绘制外框或接缝。每项仍保留键盘焦点环。单项组保留四个圆角,空组不绘制按钮。

Gap(dp) 设置有限非负间距;数值不是分段组默认的 1dp 时,每项恢复四角圆角。ResetGap() 恢复分段组默认 1dp、普通组默认 SpaceXs。Segmented(false) 恢复普通组;显式 Gap 不因模式切换而丢失。切换模式或间距不改变选中值、焦点,也不触发回调。

逐项配置使用 Item(value, toggle):

g := kit.ToggleGroup("star", "inbox").Multiple().Variant(kit.ToggleOutline).
    Item("star", kit.Toggle("", false).Icon(kit.IconStar)).
    Item("inbox", kit.Toggle("收件箱", false).Icon(kit.IconInbox))
g.SetValue("star")

value 仍是构造时的选项值,与显示文案分离。纯图标项的 Agent 名称回退到 value。Item 保存配置快照,源 Toggle 后续修改需再次调用 Item 才生效;源 Toggle 的 Value 和 OnChange 不参与组状态。组回调仍返回选项值,按原选项顺序排列。

显式逐项 Size/Variant 覆盖组配置,包括显式 Medium/Default;未配置则继承组值。逐项禁用与组禁用叠加,不清除已有选中值,也不阻止程序 SetValue。Item(value, nil) 清除覆盖,未知 value 忽略。替换配置保留该项身份与焦点。连接分段组建议统一高度,混合尺寸仍按各项高度绘制,不自动拉齐。

可用宽度不足时,分组允许横向滚动,不会压缩按钮导致文案挤在一起。滚动和调整宽度会保留选中状态与各项身份。