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.1 KiB
2.1 KiB
017 Badge 徽标
用途
显示短文字或计数。计数超过上限时显示为“上限+”。徽标可以内联排列，也可以钉在内容的某个角上。辅助技术朗读完整数值。
最小示例
unread := 120
view := func(c *ui.Context) {
core.Use(c, core.Settings{})
display.Badge(c, display.BadgeOptions{Text: "New", Tone: display.BadgeNeutral}, nil)
display.Badge(c, display.BadgeOptions{Count: unread, Label: "Unread", Position: display.BadgeTopRight}, func() {
display.Avatar(c, "Sakiko Togawa", display.AvatarOptions{})
})
}
参数
func Badge(c *ui.Context, opts BadgeOptions, content func()) ui.Element
Position 为 BadgeInline 时 content 必须为 nil；为角落位置时 content 必须不为 nil。否则 panic。
| 字段 | 类型 | 默认值 | 含义 |
|---|---|---|---|
Text |
string |
"" |
显示的文字；非空时忽略 Count。 |
Count |
int |
0 |
计数。Text 为空且计数为 0 时不显示徽标。负数 panic。 |
Max |
int |
0（即 99） |
显示上限，超过时显示 Max+。负数 panic。 |
Tone |
BadgeTone |
BadgeAccent |
BadgeAccent、BadgeNeutral、BadgeSuccess、BadgeWarning、BadgeDanger、BadgeInfo。 |
Position |
BadgePosition |
BadgeInline |
BadgeTopRight、BadgeTopLeft、BadgeBottomRight、BadgeBottomLeft：徽标中心对准内容的对应角。 |
Label |
string |
"" |
计数的含义，朗读时放在完整数值前，如“Unread 1204”。 |
状态
纯展示。字号与最小尺寸随系统文本缩放放大。强调和危险色调使用实色填充（OnAccent 配 Accent，OnDanger 配 DangerFill）；成功、警告、信息色调只把语义色用在文字和边框上。
事件
无。
键盘操作
不获取焦点。徽标的无障碍名称为 Label 加完整数值。
限制
- 角落徽标的位置相对于
content所在的盒子。内容本身有外边距时，徽标不会跟着偏移。 - 徽标使用
RoleStatus，部分屏幕阅读器可能在数值变化时主动播报。