51 lines
1.6 KiB
Markdown
51 lines
1.6 KiB
Markdown
# 481 SplitButton 拆分按钮
|
|
|
|
## 用途
|
|
|
|
主操作与下拉菜单合为一体：左半执行主操作，右半打开 `PopupMenu` 列出相关操作。两半各自获得焦点。
|
|
|
|
## 最小示例
|
|
|
|
```go
|
|
view := func(c *ui.Context) {
|
|
mujica.Use(c, mujica.Settings{})
|
|
r := mujica.SplitButton(c, "Save", mujica.SplitButtonOptions{}, func(m *mujica.PopupMenu) {
|
|
if m.Item("Save as…", mujica.PopupMenuItemOptions{}) {
|
|
// ask for a file name
|
|
}
|
|
})
|
|
if r.Changed() {
|
|
// save
|
|
}
|
|
}
|
|
```
|
|
|
|
签名：`func SplitButton(c *ui.Context, label string, opts SplitButtonOptions, build func(m *PopupMenu)) ChoiceResult`
|
|
|
|
## 参数
|
|
|
|
| 字段 | 类型 | 默认值 | 含义 |
|
|
| --- | --- | --- | --- |
|
|
| `label` | `string` | 必填 | 主操作文字。 |
|
|
| `build` | `func(*PopupMenu)` | 必填 | 填充菜单项，`Item` 报告选择。 |
|
|
| `Variant` | `ButtonVariant` | `Primary` | 只接受 `Primary` 或 `Secondary`，其余 panic。 |
|
|
| `Icon` | `*ui.SVG` | `nil` | 主操作图标。 |
|
|
| `MenuLabel` | `string` | “More options” | 菜单半的无障碍名称。 |
|
|
| `Disabled` | `bool` | `false` | 两半都不可用，打开的菜单关闭。 |
|
|
|
|
## 状态
|
|
|
|
两半分别有悬停、按下、焦点环；菜单打开时右半保持按下色。禁用时 MyGo 统一减淡。
|
|
|
|
## 事件
|
|
|
|
`Changed()`：主操作被触发。菜单项通过 `m.Item` 的返回值报告。
|
|
|
|
## 键盘操作
|
|
|
|
Tab 依次聚焦主操作与菜单按钮；Enter/Space 触发主操作；在菜单按钮上 Enter、Space 或 Down 打开菜单，方向键选择，Escape 关闭。
|
|
|
|
## 限制
|
|
|
|
菜单宽度至少等于整个按钮组；菜单内容由调用方提供。
|