ZacharyZhang-NYandClaude Opus 5.5
bcce34cda1
MyGo v0.5.5 returns ui.Element as a checked value handle instead of a
pointer. Migrated with `mygo migrate-ui`, then fixed what the codemod
leaves to review:
- Element nil checks become .Valid(); absent elements are ui.Element{}.
- Input handlers and paint callbacks run outside the build pass, where
elements expire and Context methods are inert: read IsDisabled into a
local during the build, keep a ui.Handle for Focus, use c.Services()
for clipboard access, create ui.Local state during the build.
- Add core.AutoFocus: v0.5.5 records an overlay's opener after its
content builds, so same-frame autofocus lost focus restore on close.
It focuses one frame later; cascader rows defer their focus likewise.
- core.OverlayLayer identifies build passes by the root element, not
c.Now(), which repeats across passes and under the Tester clock.
- Context menus survive the opening press counted as PressedOutside;
split button tooltip no longer reorders its open menu; disabled
menubar rows pass presses to the panel; Form defers blur-started
async checks so the growing message no longer moves Submit away
from the release; Combobox drops its disabled copy now that MyGo
blocks typing under a disabled wrapper (canary flipped to a guard).
- The Tester clock is virtual: tests use Advance/Now instead of
time.Sleep/time.Now and read element state inside the view. The web
mirror advances the clock to wall time before each frame and input.
- AGENTS.md and docs describe the value Element API and the new pin.
Snapshot goldens are darwin-only and were not re-verified here.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2.4 KiB
2.4 KiB
088 ContextMenu 右键菜单
用途
为一块区域提供应用内右键菜单，由 MujicaUI 自绘。右键在指针处打开，键盘在焦点区域下方打开，并避开窗口边缘。菜单项与 DropdownMenu 相同（PopupMenu）。
最小示例
view := func(c *ui.Context) {
core.Use(c, core.Settings{})
row := ui.Row(c).Padding(12).Children(func() {
ui.Text(c, "Letter to the Countess")
})
overlay.ContextMenu(c, row, overlay.ContextMenuOptions{}, func(m *overlay.PopupMenu) {
if m.Item("Reply", overlay.PopupMenuItemOptions{}) {
fmt.Println("reply")
}
m.Item("Delete", overlay.PopupMenuItemOptions{})
})
}
ui.Render(view, 400, 300, 1)
签名：func ContextMenu(c *ui.Context, target ui.Element, opts ContextMenuOptions, build func(m *PopupMenu)) ui.Element，返回 target。target 或 build 为 nil 时 panic。
参数
| 字段 | 类型 | 默认值 | 含义 |
|---|---|---|---|
Disabled |
bool |
false |
不响应右键与菜单键，并关闭已打开的菜单。 |
PopupMenu 的方法与选项见 087 DropdownMenu。
状态
与 DropdownMenu 菜单面板相同。右下角附近打开时，菜单向左、向上翻转，保持在窗口内。
事件
Item / Check 的返回值；每次选择只报告一次。
键盘操作
| 按键 | 行为 |
|---|---|
| Menu 键 / Shift+F10 | 焦点在 target 内时，在 target 左下方打开，焦点在第一项。 |
| 菜单内按键 | 同 DropdownMenu。 |
| Escape | 关闭，焦点回到打开前的控件。 |
限制
target必须是容器：菜单会向它追加一个不可见的定位子元素，文字元素不能有非文字子元素（MyGo 会 panic）。- 菜单通过
target.HandleInput接收右键按下，因此会替换调用方在同一元素上设置的HandleInput（ui/handler.go:73）。 - 不使用 MyGo 的
Element.ContextMenu：那是系统菜单，PRD 不允许把它当作哥特样式菜单。 - 打开期间外部点击只用于关闭，不传给下方控件：
PopoverBase用覆盖整窗的背板接收点击（ui/base.go:373）。 - Escape 只关闭最上层的 MujicaUI 浮层（窗口内按打开顺序记录）。MyGo 自带的
ui.Popover、ui.Select弹层不在这份记录中；它们打开在非模态 MujicaUI 浮层之上时，Escape 可能先关闭下面的 MujicaUI 浮层。