49 lines
1.7 KiB
Markdown
49 lines
1.7 KiB
Markdown
# 335 DebugToolbar · 调试工具栏
|
|
|
|
## 用途
|
|
|
|
调试会话的继续/暂停、单步跳过、单步进入、单步跳出、重启与停止，按会话状态禁用不适用的按钮，并注册常用快捷键。
|
|
|
|
## 最小示例
|
|
|
|
```go
|
|
state := mujica.DebugPaused
|
|
view := func(c *ui.Context) {
|
|
mujica.Use(c, mujica.Settings{})
|
|
switch mujica.DebugToolbar(c, state, mujica.DebugToolbarOptions{}).Action {
|
|
case mujica.DebugContinue:
|
|
state = mujica.DebugRunning
|
|
case mujica.DebugStop:
|
|
state = mujica.DebugStopped
|
|
}
|
|
}
|
|
ui.Render(view, 400, 300, 1)
|
|
```
|
|
|
|
## 参数
|
|
|
|
`func DebugToolbar(c *ui.Context, state DebugState, opts DebugToolbarOptions) DebugToolbarResult`。`DebugEnabled(state, action)` 给出禁用规则：运行中只能暂停、重启、停止；暂停时可继续、单步、重启、停止；停止时只能“开始”（`DebugContinue`）。
|
|
|
|
| 字段 | 类型 | 默认值 | 含义 |
|
|
| --- | --- | --- | --- |
|
|
| `state` | `DebugState` | — | `DebugStopped`、`DebugRunning`、`DebugPaused`；越界 panic。 |
|
|
| `Disabled` | `bool` | false | 全部按钮与快捷键无效。 |
|
|
|
|
## 状态
|
|
|
|
运行中第一个按钮显示暂停，否则显示继续（停止时名为“开始”）；不适用的按钮禁用；按钮悬停、按下、焦点环与带快捷键的提示。
|
|
|
|
## 事件
|
|
|
|
`Action`：本帧请求的 `DebugAction`，无则为 `DebugNone`。
|
|
|
|
## 键盘操作
|
|
|
|
- F5 继续/开始，F6 暂停，F10 单步跳过，F11 单步进入，Shift+F11 单步跳出，Cmd/Ctrl+Shift+F5 重启，Shift+F5 停止（窗口内全局，焦点控件优先处理）。
|
|
- 工具栏是一个 Tab 停靠点，←/→ 在按钮间移动。
|
|
|
|
## 限制
|
|
|
|
- 快捷键固定，不可配置；同一窗口只放一个调试工具栏。
|
|
- 图标为自绘 SVG。
|