Keel v0.5.1 English GitHub

ShimmerText

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

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

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

package main

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

func init() {
	registerSection("shimmer_text", "motion", func() core.Widget {
		normal := kit.ShimmerText(demoText("Generating content; the text remains readable…", "正在生成内容,文字仍然可以阅读……")).Size(20)
		reverse := kit.ShimmerText(demoText("Reverse sweep", "反向扫光 · Reverse")).Size(24).Style(kit.ShimmerStyle{Duration: 3 * time.Second, Spread: .4, Reverse: true})
		once := kit.ShimmerText(demoText("Play once", "只播放一次 · Once")).Size(20).Once(true)
		return el.Embed(el.ViewFunc(func(cx *el.Context) el.Element {
			return el.Div().P(24).Gap(20).Child(normal.Render(cx), reverse.Render(cx), once.Render(cx), kit.Button(demoText("Replay", "重新播放"), once.Restart).Render(cx))
		}))
	})
}

保留可读文字,让高光扫过字形;背景和字间空白不受影响。

loading := kit.ShimmerText("正在生成内容……").Duration(2*time.Second).Spread(.3)
loading.Reverse(true).Once(true)
loading.Restart()

默认从左向右循环,周期 2 秒,高光半宽为文字框宽度的 30%。Duration 接受正时长;Spread 接受 (0,1],非法值忽略。Reverse 反向;Once 在一个周期后恢复普通文字并停止请求动画帧,Restart 重新开始。调整时长不重置起点,需要时显式 Restart。

Enabled(false) 显示普通文字,再启用从头开始;减少动画设置下同样显示普通文字。SetText 更新正文,Size 设置字号(0 继承),MaxLines 限制行数(0 不限);字体、字重、行高和颜色默认从 el 容器继承。Color 覆盖文字底色,Highlight 覆盖高光颜色,默认高光使用主题 PrimaryText。

彩色位图字形(例如部分 emoji)保留原色,不参与高光着色。组件保持文本语义与布局尺寸,不承担加载任务,也不提供文字选择。底层 el.Text(...).Shimmer(phase, spread, color) 只负责绘制,便于应用自定义时间控制。

运行示例:go run ./examples/components -section shimmer_text。

ShimmerStyle 是可复用的动画配置值,含 Duration、Spread、Reverse、Once;Style(config) 一次替换四项配置,正文、字号、颜色等保持不变。零值恢复默认值;非正 Duration、超出 (0,1] 或非有限 Spread 使用默认值。有效配置变化会从下一帧重新播放,重复应用相同配置不会重启动画。逐项 Duration/Spread 等原有方法仍保留原来的行为。

motion := kit.ShimmerStyle{Duration: 3*time.Second, Spread: .45, Reverse: true, Once: false}
text.Style(motion)
attachment.TitleShimmer(motion)