# 067 Toolbar 工具栏

## 用途

一行操作按钮：分组、分隔线；宽度不足时，放不下的按钮从末尾起移入溢出菜单。基于 MyGo `ui.Toolbar`，保留其焦点组与溢出行为。

## 最小示例

```go
mujica.Toolbar(c, mujica.ToolbarOptions{Label: "Format"}, func() {
	mujica.ToolbarGroup(c, func() {
		mujica.ToolbarButton(c, "Bold", mujica.ToolbarButtonOptions{Icon: icons.Must("bold")})
		mujica.ToolbarButton(c, "Italic", mujica.ToolbarButtonOptions{Icon: icons.Must("italic")})
	})
	mujica.ToolbarSeparator(c)
	if mujica.ToolbarButton(c, "Copy", mujica.ToolbarButtonOptions{Icon: icons.Must("copy"), ShowLabel: true}).Clicked() {
		copySelection()
	}
})
```

签名：

- `func Toolbar(c *ui.Context, opts ToolbarOptions, fn func()) *ui.Element`
- `func ToolbarButton(c *ui.Context, label string, opts ToolbarButtonOptions) *ui.Element`
- `func ToolbarGroup(c *ui.Context, fn func()) *ui.Element`
- `func 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 主题。