MujicaUI

Agent · #268

AgentProgress 浅色主题渲染快照
浅色 · 渲染快照
AgentProgress 深色主题渲染快照
深色 · 渲染快照

268 AgentProgress Agent 进度

用途

显示整体进度和当前动作文字;时长未知时用不确定模式。

最小示例

view := func(c *ui.Context) {
	core.Use(c, core.Settings{})
	agent.AgentProgress(c, 0.4, agent.AgentProgressOptions{Action: "Reading ledger.md"})
}
ui.Render(view, 400, 300, 1)

签名:func AgentProgress(c *ui.Context, value float64, opts AgentProgressOptions) *ui.Element。确定模式下 value 不在 0 到 1 时 panic。

参数

字段类型默认值含义
Labelstring“进度”进度名称。
Actionstring""当前动作,如“正在读取 ledger.md”。
Indeterminateboolfalse不确定模式,忽略 value。
Stillboolfalse停止执行中动画;系统减少动画时也自动静止。

状态

  • 确定模式显示百分比;不确定模式显示流动条,减少动画时为静态条加“进行中”。

事件

  • 无事件;当前动作以状态角色读出。

键盘操作

  • 不获取焦点。

限制

  • 进度值由调用方计算。