SelectMenu

在可搜索的弹出列表中选择项目。

实时预览

正在加载预览…

参数配置

占位文字 placeholder颜色 color尺寸 size样式 variant禁用 disabled否加载中 loading否多选 multiple否搜索框 search

全部字段 36

SelectMenuItems

列表项 · 3

ListboxItem

ID

Label

Description

Group

Disabled

Icon

ListboxItem

ID

Label

Description

Group

Disabled

Icon

ListboxItem

ID

Label

Description

Group

Disabled

Icon

SelectMenuOptions

Build

Label

EmptyText

Multiple

Disabled

Height

Orientation

ItemWidth

Loop

HighlightOnHover

SelectionBehavior

OnChange

OnSelect

UI

Styles · 0

Style

Color

Variant

Size

SearchInput

ResetSearchTermOnBlur

ResetSearchTermOnSelect

Placeholder

Invalid

ErrorMessage

SearchPlaceholder

Clearable

Loading

ExternalFilter

Error

OnQuery

OnCreate

FilterFields

列表项 · 0

CreateWhenAlways

CreateAtTop

Popup

PopoverOptions

Label无障碍名称

Placement

Width

MaxHeight

Offset

MatchAnchor

Mode

OpenDelayms仅悬停

CloseDelayms仅悬停

Dismissible

UI

Styles · 0

Style

Go 代码

// Inside a view; c is *ui.Context, t is nui.Theme.
// Keep s (example state) outside the view. See the complete example.
nui.SelectMenu(c.Key("select"), t, &s.Values, &s.Menu, []nui.ListboxItem{{ID: "go", Label: "Go", Description: "Native applications"}, {ID: "rust", Label: "Rust", Description: "Systems programming"}, {ID: "typescript", Label: "TypeScript", Description: "Web applications"}}, nui.SelectMenuOptions{ListboxOptions: nui.ListboxOptions{Label: "Languages", Multiple: false, Disabled: false}, Placeholder: "Type something…", SearchInput: nui.Optional[bool]{}, Clearable: true, Loading: false, Color: nui.ColorDefault, Size: nui.SizeDefault, Variant: nui.VariantDefault})

使用说明

展开菜单搜索并选择语言，试试多选、搜索开关和加载状态。示例同时保存所选 ID 与 SelectMenu 状态；清空操作不会重新创建选项数据。

API 参考

SelectMenu

源码

func SelectMenu(c *ui.Context, t Theme, value *[]string, s *SelectMenuState, items []ListboxItem, o SelectMenuOptions) ui.Element

SelectMenuOptions

源码

type SelectMenuOptions struct {
	ListboxOptions
	Color                                          Color
	Variant                                        Variant
	Size                                           Size
	SearchInput                                    Optional[bool]
	ResetSearchTermOnBlur, ResetSearchTermOnSelect Optional[bool]
	Placeholder                                    string
	Invalid                                        bool
	ErrorMessage                                   string
	SearchPlaceholder                              string
	Clearable, Loading, ExternalFilter             bool
	Error                                          string
	OnQuery                                        func(string)
	OnCreate                                       func(string)
	FilterFields                                   []string // label (default), description, value/id, group.
	CreateWhenAlways, CreateAtTop                  bool
	Popup                                          PopoverOptions
}

字段	类型	说明
`Build`	`func(*ui.Context, Theme, ListboxItem)` Go 零值: `nil`	同步构建当前项目的视觉内容。
`Label`	`string` Go 零值: `""`	控件标签或可访问名称。
`EmptyText`	`string` Go 零值: `""`	没有可显示数据时的文案。
`Multiple`	`bool` Go 零值: `false`	允许选择多个项目。
`Disabled`	`bool` Go 零值: `false`	禁用组件及其交互。
`Height`	`float32` Go 零值: `0`	高度，单位为 DIP。
`Orientation`	`Optional[Orientation]` Go 零值: `unset`	水平或垂直方向；未设置时使用组件默认方向。
`ItemWidth`	`float32` Go 零值: `0`	横向列表项的宽度。
`Loop`	`bool` Go 零值: `false`	键盘导航到边界时循环。
`HighlightOnHover`	`Optional[bool]` Go 零值: `unset`	悬停时高亮列表项。
`SelectionBehavior`	`SelectionBehavior` Go 零值: `zero value`	控制列表选择的切换或替换策略。
`OnChange`	`func([]string)` Go 零值: `nil`	值发生变化时通知应用的回调。
`OnSelect`	`func(string)` Go 零值: `nil`	激活或选择项目时通知应用的回调。
`UI`	`Styles` Go 零值: `zero value`	以部件名称为键覆盖外观和间距。
`Style`	`func(Slot, ui.Element)` Go 零值: `nil`	同步配置当前构建的部件；不要保留 Element。
`Color`	`Color` Go 零值: `ColorDefault`	语义颜色；默认值继承主题或组件配色。
`Variant`	`Variant` Go 零值: `VariantDefault`	组件外观样式，支持范围取决于组件。
`Size`	`Size` Go 零值: `SizeDefault`	组件尺寸；默认值继承主题或组件尺寸。
`SearchInput`	`Optional[bool]` Go 零值: `unset`	是否显示搜索框；未设置时使用组件默认策略。
`ResetSearchTermOnBlur`	`Optional[bool]` Go 零值: `unset`	关闭或失焦时重置搜索词。
`ResetSearchTermOnSelect`	`Optional[bool]` Go 零值: `unset`	选中项目后重置搜索词。
`Placeholder`	`string` Go 零值: `""`	没有输入或选择时的占位文字。
`Invalid`	`bool` Go 零值: `false`	使用无效输入的视觉状态。
`ErrorMessage`	`string` Go 零值: `""`	显式提供的错误说明。
`SearchPlaceholder`	`string` Go 零值: `""`	搜索输入框的占位文字。
`Clearable`	`bool` Go 零值: `false`	显示清空操作或允许清除当前值。
`Loading`	`bool` Go 零值: `false`	显示加载状态；是否阻止操作由组件决定。
`ExternalFilter`	`bool` Go 零值: `false`	由应用提供已筛选结果。
`Error`	`string` Go 零值: `""`	错误状态或错误说明。
`OnQuery`	`func(string)` Go 零值: `nil`	搜索词变化时通知应用的回调。
`OnCreate`	`func(string)` Go 零值: `nil`	请求创建项目时通知应用的回调。
`FilterFields`	`[]string` Go 零值: `nil`	搜索时匹配的项目字段。
`CreateWhenAlways`	`bool` Go 零值: `false`	即使存在匹配项也提供创建操作。
`CreateAtTop`	`bool` Go 零值: `false`	将创建操作放在候选列表顶部。
`Popup`	`PopoverOptions` Go 零值: `zero value`	候选弹层的配置。