CheckboxGroup

从一组选项中进行选择。

实时预览

正在加载预览…

参数配置

全部字段 16

CheckboxGroupItems

列表项 · 3
Option[string]
Option[string]
Option[string]

ChoiceGroupOptions

Styles · 0

Go 代码

Go
// Inside a view; c is *ui.Context, t is nui.Theme.
// Keep s (example state) outside the view. See the complete example.
nui.CheckboxGroup(c.Key("choices"), t, &s.Values, []nui.Option[string]{{Value: "go", Label: "Go"}, {Value: "rust", Label: "Rust"}, {Value: "typescript", Label: "TypeScript"}}, nui.CheckboxGroupOptions{Label: "Languages", Color: nui.ColorDefault, Size: nui.SizeDefault, Disabled: false, Horizontal: false})
ui.Textf(c, "Selected: %v", s.Values)

使用说明

从语言列表中选择多个值，所选集合显示在下方。每个 Option 的 Value 是业务值，Label 是展示文字；改变横向布局不会重建选择数据。

API 参考

CheckboxGroup

源码 
func CheckboxGroup[T comparable](c *ui.Context, t Theme, selected *[]T, options []Option[T], o CheckboxGroupOptions) ui.Element

CheckboxGroupOptions

源码 
type CheckboxGroupOptions = ChoiceGroupOptions
字段类型说明
Labelstring

Go 零值: ""

控件标签或可访问名称。

Descriptionstring

Go 零值: ""

补充说明文字。

ErrorMessagestring

Go 零值: ""

显式提供的错误说明。

Disabledbool

Go 零值: false

禁用组件及其交互。

Invalidbool

Go 零值: false

使用无效输入的视觉状态。

Horizontalbool

Go 零值: false

启用横向排列。

ColorColor

Go 零值: ColorDefault

语义颜色；默认值继承主题或组件配色。

SizeSize

Go 零值: SizeDefault

组件尺寸；默认值继承主题或组件尺寸。

MaxOptional[int]

Go 零值: unset

上界或数量上限，具体含义依组件而定。

VariantChoiceVariant

Go 零值: zero value

组件外观样式，支持范围取决于组件。

IndicatorIndicatorPlacement

Go 零值: zero value

选择指示器的位置或隐藏策略。

Highlightbool

Go 零值: false

突出显示控件或选中项目。

OnChangefunc()

Go 零值: nil

值发生变化时通知应用的回调。

UIStyles

Go 零值: zero value

以部件名称为键覆盖外观和间距。

Stylefunc(Slot, ui.Element)

Go 零值: nil

同步配置当前构建的部件；不要保留 Element。