# 023 ButtonGroup 按钮组

## 用途

把若干按钮拼成一条，共用边框与尺寸，只有外侧圆角。整个组是一个 Tab 停靠点，组内用方向键移动。基于 `ui.ButtonBase` 与 MyGo 焦点组 `FocusGroup`。

## 最小示例

```go
items := []input.ButtonGroupItem{{Label: "Day"}, {Label: "Week"}, {Label: "Month"}}
if i := input.ButtonGroup(c, items, input.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）。