MujicaUI/docs/components/084-popover.md

084 Popover 弹出框

用途

在锚点下方显示可交互的面板；空间不足时翻到上方，并保持在窗口内。外部点击与 Escape 关闭。

最小示例

open := true
view := func(c *ui.Context) {
	mujica.Use(c, mujica.Settings{})
	b := mujica.Button(c, "Guests", mujica.ButtonOptions{Variant: mujica.Secondary})
	if b.Clicked() {
		open = !open
	}
	mujica.Popover(c, b, &open, mujica.PopoverOptions{Title: "Guest list"}, func() {
		ui.Text(c, "Twelve guests confirmed.")
	})
}
ui.Render(view, 400, 300, 1)

签名：func Popover(c *ui.Context, anchor *ui.Element, open *bool, opts PopoverOptions, content func()) *ui.Element。anchor 必须是本帧已构建的元素，nil 时 panic。

参数

字段	类型	默认值	含义
Title	string	""	面板顶部的衬线标题，同时命名面板。
Width	float32	0	固定宽度；0 时随内容，至少与锚点同宽，最多 360。
Label	string	""	无标题时的无障碍名称。

状态

• 6 DIP 圆角、Surface 底色、1 DIP 边框、160 ms 淡入。
• 面板最高为锚点上下较大一侧的空间，超出时滚动。
• 锚点首帧尚未布局时面板保持透明，避免闪到窗口左上角。

事件

外部点击与 Escape 把 *open 设为 false；内容内控件自行报告事件。

键盘操作

按键	行为
Tab	从锚点进入弹层，弹层元素紧跟锚点排序。
Escape	关闭并把焦点还给锚点。

限制

• 只支持下方与上方两个位置：位置由 MyGo PopoverBase 决定（ui/widgets.go:689 keepInWindow）。
• 打开时外部点击只用于关闭，不会传给下方控件：PopoverBase 用覆盖整窗的背板接收点击（ui/base.go:373）。