Keel v0.5.1 English GitHub

Spinner

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

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

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

package main

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

func init() {
	registerSection("spinner", "feedback", func() core.Widget { return el.Embed(spinnerGallery{}) })
}

type spinnerGallery struct{}

func (spinnerGallery) Render(cx *el.Context) el.Element {
	return el.Div().Gap(16).Child(kit.Spinner().Label(demoText("Loading orders 123", "正在加载订单 123")).Render(cx), kit.Spinner().Size(32).Label("").Render(cx), kit.Spinner().Icon(kit.IconSettings).Size(32).Color(theme.Primary).Label(demoText("Custom gear icon", "自定义齿轮图标")).Render(cx), kit.Spinner().Icon(kit.IconClock).Period(2*time.Second).Size(24).Color(theme.Muted).Label(demoText("Waiting · One cycle every two seconds", "等待处理 · 两秒一周")).Render(cx), el.Div().OnClick(func() { theme.SetReducedMotion(!theme.ReducedMotion) }).P(8).Child(el.Text(demoText("Toggle reduced motion", "切换减少动画"))))
}

kit.Spinner().Size(20).Label("加载中") 显示不确定进度。Label 为空时只画图形,默认名称为“加载中”。Agent 角色 progressbar,value 为 indeterminate。没有键盘操作。

旋转相位在绘制时通过 el.AmbientPhase 读取,并请求所有循环指示器共用的下一个 30 Hz 刻度,不启动 goroutine。窗口中只有 Spinner 在动时,这些帧直接重绘,不再渲染视图(纯绘制帧,见 el 指南)。theme.SetReducedMotion(true) 后保持静态。固定图形尺寸,文本按父容器约束换行。

验证:go run ./examples/components -section spinner -theme dark,省略 theme 查看浅色;示例按钮切换减少动画。像素测试注入不同帧时间,检查旋转和静止。

Icon(kit.IconSettings) 将圆环替换为旋转图标,Icon(kit.IconNone) 恢复圆环;VectorIcon 接受自定义 Gio 图标,传 nil 恢复圆环。Color(color.NRGBA{...}) 设置图形颜色,标签仍使用主题的 Muted 色。未设置颜色时随主题使用 PrimaryText。自定义图标与圆环默认每秒一周,减少动画时静止;尺寸与 Agent 语义保持一致。

Period(2 * time.Second) 设置旋转一周的时间,数值越大转得越慢;0 恢复默认一秒,负值忽略。周期变化立即按共享帧时钟重新计算相位,可能改变当前角度。减少动画优先于周期设置。按钮等加载控件仍使用默认周期。