Keel v0.5.1 English GitHub

ProgressCircle

在线示例:这是真实的 Keel 程序编译成 WebAssembly,可以直接操作。首次加载约 10 MB。全屏打开
示例代码Go · 可复制

这是上方组件库展示案例的完整源码。examples/components/progress_circle.go

在脚手架项目中复用组件构造和 Render 写法;示例的 registerSection 与共享辅助函数由组件库提供。

package main

import (
	"fmt"
	"github.com/dyike/keel/ui/core"
	"github.com/dyike/keel/ui/el"
	"github.com/dyike/keel/ui/kit"
	"github.com/dyike/keel/ui/theme"
)

func init() {
	registerSection("progress_circle", "feedback", func() core.Widget {
		done := kit.ProgressCircle(demoText("Import", "导入")).Size(88)
		done.SetValue(.42)
		done.Child(el.ViewFunc(func(*el.Context) el.Element { return el.Text(fmt.Sprintf("%.0f%%", done.Value()*100)) }))
		empty := kit.ProgressCircle(demoText("Not started", "未开始 Empty")).Size(40)
		full := kit.ProgressCircle(demoText("Done", "已完成")).Size(40)
		full.SetValue(1)
		busy := kit.ProgressCircle(demoText("Sync", "同步")).Size(40)
		busy.SetIndeterminate(true)
		return el.Embed(el.ViewFunc(func(cx *el.Context) el.Element {
			return el.Div().P(theme.SpaceXl).Gap(theme.SpaceLg).W(el.Dp(360)).MaxW(el.Full).Child(
				el.Div().Row().Wrap().Items(el.Center).Gap(theme.SpaceLg).Child(done.Render(cx), empty.Render(cx), full.Render(cx), busy.Render(cx)),
				el.Div().Row().Wrap().Gap(theme.SpaceSm).Child(
					kit.Button("+10%", func() { done.SetValue(done.Value() + .1) }).Render(cx),
					kit.Button(demoText("Reset", "重置"), func() { done.SetValue(0) }).Render(cx)))
		}))
	})
}

圆形进度显示,支持真实进度、不确定动画和中心内容。

p := kit.ProgressCircle("导入订单").Size(64)
p.SetValue(.42)
p.Child(el.ViewFunc(func(*el.Context) el.Element {
    return el.Text(fmt.Sprintf("%.0f%%", p.Value()*100))
}))

Value/SetValue 读写 0–1 的进度;赋值退出不确定模式。NaN 归零,无穷和越界值限制到端点。SetIndeterminate(true) 显示旋转弧,减少动画时静止;切回确定模式保留之前的值。

Size 设置直径(默认 48dp,忽略非正数和非有限数);Color 显式覆盖前景色,默认随主题切换。SetLabel 更新语义名称,Child 设置中心视图,传 nil 清空。中心内容应简短,绘制裁剪在组件范围内。窄约束下圆环取可用宽高的较小值居中绘制。

纯展示组件,不接收键盘焦点。Agent 角色为 progressbar,名称取 label,值为百分比或 indeterminate。应用负责更新状态;后台更新应通过 core.Update。

验证:go run ./examples/components -section progress_circle,以 -theme dark 检查深色,-width 320 -scale 2 -screenshot /tmp/progress-circle.png 检查窄布局。单元测试覆盖状态和约束,窗口测试覆盖 Agent 值与动画像素。

确定进度更新使用 200ms 平滑过渡(kit.ProgressDuration),连续更新从当前显示位置衔接。首次显示、从不确定模式返回和减少动画时立即显示目标值。Value()、百分比及 Agent 语义始终返回目标值,只有图形插值;中心自定义内容由调用方管理。动画使用帧时钟,不创建定时器或 goroutine。