Tooltip

悬停或聚焦时显示简短提示。

实时预览

正在加载预览…

参数配置

提示文字 label禁用 disabled否

全部字段 8

TooltipOptions

Disabled

MaxWidth

Placement

Offset

Open

Kbds

列表项 · 2

UI

Styles · 0

Style

Go 代码

// Inside a view; c is *ui.Context, t is nui.Theme.
anchor := nui.Button(c.Key("trigger"), t, "Hover or focus", nui.ButtonOptions{Variant: nui.Outline})
nui.Tooltip(c.Key("tooltip"), t, anchor, "Search this workspace", nui.TooltipOptions{Disabled: false, Kbds: []string{"Ctrl", "K"}})

使用说明

把指针移到按钮上，或通过键盘聚焦它，查看提示与快捷键说明。提示适合补充简短信息；关键操作说明应同时出现在可见界面中。

API 参考

Tooltip

源码

func Tooltip(c *ui.Context, t Theme, anchor ui.Element, text string, o TooltipOptions) ui.Element

TooltipOptions

源码

type TooltipOptions struct {
	Disabled  bool
	MaxWidth  Optional[float32]
	Placement Optional[Placement]
	Offset    Optional[float32]
	Open      *bool
	Kbds      []string
	Decoration
}

字段	类型	说明
`Disabled`	`bool` Go 零值: `false`	禁用组件及其交互。
`MaxWidth`	`Optional[float32]` Go 零值: `unset`	最大宽度，单位为 DIP。
`Placement`	`Optional[Placement]` Go 零值: `unset`	弹层相对触发控件的位置。
`Offset`	`Optional[float32]` Go 零值: `unset`	弹层与触发控件的距离。
`Open`	`*bool` Go 零值: `nil`	受控的打开状态。
`Kbds`	`[]string` Go 零值: `nil`	在提示中显示的快捷键。
`UI`	`Styles` Go 零值: `zero value`	以部件名称为键覆盖外观和间距。
`Style`	`func(Slot, ui.Element)` Go 零值: `nil`	同步配置当前构建的部件；不要保留 Element。