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.5 KiB
2.5 KiB
067 Toolbar 工具栏
用途
一行操作按钮：分组、分隔线；宽度不足时，放不下的按钮从末尾起移入溢出菜单。基于 MyGo ui.Toolbar，保留其焦点组与溢出行为。
最小示例
navigation.Toolbar(c, navigation.ToolbarOptions{Label: "Format"}, func() {
navigation.ToolbarGroup(c, func() {
navigation.ToolbarButton(c, "Bold", navigation.ToolbarButtonOptions{Icon: icons.Must("bold")})
navigation.ToolbarButton(c, "Italic", navigation.ToolbarButtonOptions{Icon: icons.Must("italic")})
})
navigation.ToolbarSeparator(c)
if navigation.ToolbarButton(c, "Copy", navigation.ToolbarButtonOptions{Icon: icons.Must("copy"), ShowLabel: true}).Clicked() {
fmt.Println("copy")
}
})
签名：
func Toolbar(c *ui.Context, opts ToolbarOptions, fn func()) ui.Elementfunc ToolbarButton(c *ui.Context, label string, opts ToolbarButtonOptions) ui.Elementfunc ToolbarGroup(c *ui.Context, fn func()) ui.Elementfunc ToolbarSeparator(c *ui.Context)
参数
ToolbarOptions
| 字段 | 类型 | 默认值 | 含义 |
|---|---|---|---|
Label |
string |
"" | 工具栏的无障碍名称。 |
ToolbarButton 的 label 必填（为空时 panic）：它是按钮名称、仅图标时的提示文字和溢出菜单中的文字。
ToolbarButtonOptions
| 字段 | 类型 | 默认值 | 含义 |
|---|---|---|---|
Icon |
*ui.SVG |
nil | 16 DIP 图标。 |
ShowLabel |
bool |
false | 图标旁显示文字；没有图标时总是显示。 |
Disabled |
bool |
false | 禁用；溢出菜单中同样禁用。 |
状态
- 工具栏：Surface 背景、Border 边框、4 DIP 圆角。
- 按钮：无底色，悬停 SurfaceHover，按下 Selection，焦点环 2 DIP。
- 分隔线：旧金细竖线，不进入无障碍树。
- 溢出：末尾显示 “»” 按钮，菜单中按原顺序列出被收起的操作，组之间以分隔线隔开。
事件
ToolbarButton(...).Clicked()：点击、Enter / Space，或在溢出菜单中选择。
键盘操作
- Tab：进入工具栏（一个停靠点），再按 Tab 离开。
- ←/→：在操作之间移动（跳过禁用项并循环）；Home / End 到首末。
- Enter / Space：执行。溢出按钮用 Enter、Space 或 ↓ 打开菜单。
限制
- 溢出菜单是 MyGo 打开的系统菜单（
ui/toolbar.go:45），外观为系统样式，不是 MujicaUI 自绘。 - 溢出按钮的无障碍名称固定为英文 “More”（
ui/toolbar.go:44），按钮样式来自 MyGo 主题。