54 lines
1.7 KiB
Markdown
54 lines
1.7 KiB
Markdown
# 023 ButtonGroup 按钮组
|
||
|
||
## 用途
|
||
|
||
把若干按钮拼成一条，共用边框与尺寸，只有外侧圆角。整个组是一个 Tab 停靠点，组内用方向键移动。基于 `ui.ButtonBase` 与 MyGo 焦点组 `FocusGroup`。
|
||
|
||
## 最小示例
|
||
|
||
```go
|
||
items := []mujica.ButtonGroupItem{{Label: "Day"}, {Label: "Week"}, {Label: "Month"}}
|
||
if i := mujica.ButtonGroup(c, items, mujica.ButtonGroupOptions{Label: "Range"}).ClickedItem(); i >= 0 {
|
||
fmt.Println("chose", items[i].Label)
|
||
}
|
||
```
|
||
|
||
签名：`func ButtonGroup(c *ui.Context, items []ButtonGroupItem, opts ButtonGroupOptions) ButtonGroupResult`
|
||
|
||
## 参数
|
||
|
||
`ButtonGroupItem`
|
||
|
||
| 字段 | 类型 | 默认值 | 含义 |
|
||
| --- | --- | --- | --- |
|
||
| `Label` | `string` | `""` | 文字；与 `Icon` 至少给一个，否则 panic。 |
|
||
| `Icon` | `*ui.SVG` | `nil` | 图标。 |
|
||
| `Name` | `string` | `""` | 仅图标项的无障碍名称；仅图标且为空时 panic。 |
|
||
| `Disabled` | `bool` | `false` | 单项禁用；方向键跳过该项。 |
|
||
|
||
`ButtonGroupOptions`
|
||
|
||
| 字段 | 类型 | 默认值 | 含义 |
|
||
| --- | --- | --- | --- |
|
||
| `Vertical` | `bool` | `false` | 纵向排列，使用上下方向键。 |
|
||
| `Label` | `string` | `""` | 组的无障碍名称（工具栏角色）。 |
|
||
| `Disabled` | `bool` | `false` | 禁用整组。 |
|
||
|
||
`items` 为空时 panic。
|
||
|
||
## 状态
|
||
|
||
每项有悬停、按下、聚焦、禁用；相邻项共用一条 1 DIP 分隔边。
|
||
|
||
## 事件
|
||
|
||
`ClickedItem()` 返回本帧被点击项的下标，无点击时为 -1。
|
||
|
||
## 键盘操作
|
||
|
||
Tab 进入组（回到上次聚焦项）；横向组 Left/Right、纵向组 Up/Down 移动并循环；Home、End 到首末项；Enter 或 Space 触发。
|
||
|
||
## 限制
|
||
|
||
- 组内没有选中概念；需要保持选中请使用 ToggleGroup（033）。
|