InputTags

输入、添加和移除标签。

实时预览

正在加载预览…

参数配置

标签 label占位文字 placeholder颜色 color尺寸 size样式 variant禁用 disabled否只读 readOnly否加载中 loading否标签上限 maximum粘贴添加 paste

全部字段 30

InputTagsOptions

Label

Placeholder

ErrorMessage

Disabled

ReadOnly

Invalid

Password

Clearable

ClearLabel

Color

Variant

Size

Leading

Trailing

Loading

LoadingIcon

Highlight

OnChange

OnSubmit

OnClear

UI

Styles · 0

Style

MaxTags

Separators

AddOnTab

AddOnBlur

Duplicate

AddOnPaste

MaxLength

OnTagsChange

Go 代码

// Inside a view; c is *ui.Context, t is nui.Theme.
// Keep s (example state) outside the view. See the complete example.
nui.InputTags(c.Key("tags"), t, &s.Values, &s.Tags, nui.InputTagsOptions{InputOptions: nui.InputOptions{Label: "Project name", Placeholder: "Type something…", Color: nui.ColorDefault, Size: nui.SizeDefault, Variant: nui.VariantDefault, Disabled: false, ReadOnly: false, Loading: false}, MaxTags: 6, AddOnPaste: nui.Optional[bool]{}})

使用说明

输入标签后确认添加，或尝试粘贴与删除，maximum 限制标签数量。标签集合与编辑状态分别保存；禁用和只读行为通过嵌入的 InputOptions 配置。

API 参考

InputTags

源码

func InputTags(c *ui.Context, t Theme, value *[]string, s *TagsState, o InputTagsOptions) ui.Element

InputTagsOptions

源码

type InputTagsOptions struct {
	InputOptions
	MaxTags                        int
	Separators                     string
	AddOnTab, AddOnBlur, Duplicate bool
	AddOnPaste                     Optional[bool]
	MaxLength                      int // Native editing limit in UTF-16 units; 0 is unlimited.
	OnTagsChange                   func([]string)
}

字段	类型	说明
`Label`	`string` Go 零值: `""`	控件标签或可访问名称。
`Placeholder`	`string` Go 零值: `""`	没有输入或选择时的占位文字。
`ErrorMessage`	`string` Go 零值: `""`	显式提供的错误说明。
`Disabled`	`bool` Go 零值: `false`	禁用组件及其交互。
`ReadOnly`	`bool` Go 零值: `false`	允许读取和选择内容，但禁止编辑。
`Invalid`	`bool` Go 零值: `false`	使用无效输入的视觉状态。
`Password`	`bool` Go 零值: `false`	遮蔽输入内容。
`Clearable`	`bool` Go 零值: `false`	显示清空操作或允许清除当前值。
`ClearLabel`	`string` Go 零值: `""`	清空操作的可访问名称。
`Color`	`Color` Go 零值: `ColorDefault`	语义颜色；默认值继承主题或组件配色。
`Variant`	`Variant` Go 零值: `VariantDefault`	组件外观样式，支持范围取决于组件。
`Size`	`Size` Go 零值: `SizeDefault`	组件尺寸；默认值继承主题或组件尺寸。
`Leading`	`*ui.SVG` Go 零值: `nil`	内容前方的 SVG 图标。
`Trailing`	`*ui.SVG` Go 零值: `nil`	内容后方的 SVG 图标。
`Loading`	`bool` Go 零值: `false`	显示加载状态；是否阻止操作由组件决定。
`LoadingIcon`	`*ui.SVG` Go 零值: `nil`	覆盖默认加载图标。
`Highlight`	`bool` Go 零值: `false`	突出显示控件或选中项目。
`MaxLength`	`int` Go 零值: `0`	输入长度上限，原生文本以 UTF-16 单元计数；零表示不限。
`OnChange`	`func(string)` Go 零值: `nil`	值发生变化时通知应用的回调。
`OnSubmit`	`func(string)` Go 零值: `nil`	提交表单或输入时通知应用的回调。
`OnClear`	`func()` Go 零值: `nil`	清空值时通知应用的回调。
`UI`	`Styles` Go 零值: `zero value`	以部件名称为键覆盖外观和间距。
`Style`	`func(root, editor, leading, trailing ui.Element)` Go 零值: `nil`	同步配置当前构建的部件；不要保留 Element。
`MaxTags`	`int` Go 零值: `0`	标签数量上限。
`Separators`	`string` Go 零值: `""`	用于拆分标签的分隔字符。
`AddOnTab`	`bool` Go 零值: `false`	按 Tab 时添加标签。
`AddOnBlur`	`bool` Go 零值: `false`	失去焦点时添加标签。
`Duplicate`	`bool` Go 零值: `false`	允许重复标签。
`AddOnPaste`	`Optional[bool]` Go 零值: `unset`	粘贴时解析并添加标签。
`MaxLength`	`int` Go 零值: `0`	输入长度上限，原生文本以 UTF-16 单元计数；零表示不限。
`OnTagsChange`	`func([]string)` Go 零值: `nil`	标签列表变化时通知应用的回调。