Skeleton
示例代码Go · 可复制
这是上方组件库展示案例的完整源码。examples/components/skeleton.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"
)
func init() {
registerSection("skeleton", "feedback", func() core.Widget { return el.Embed(&skeletonGallery{}) })
}
type skeletonGallery struct{ loaded bool }
func (v *skeletonGallery) Render(cx *el.Context) el.Element {
card := el.Div().P(20).MinH(el.Dp(200)).Gap(12).W(el.Dp(360)).MaxW(el.Full).Rounded(theme.RadiusMd).Bg(theme.Surface).Border(1, theme.Outline)
label := demoText("Simulate loading complete", "模拟加载完成")
if v.loaded {
label = demoText("Reload", "重新加载")
card.Child(el.Text(demoText("Keel component gallery", "Keel 组件库")).Bold(), el.Text(demoText("Loaded content replaces the gray placeholders.", "加载完成后,真实内容替换灰色占位。")), el.Text(demoText("Reserve space for the avatar, title, and body.", "头像、标题和正文都可以预先保留空间。")).TextColor(theme.Muted))
} else {
card.Child(kit.Skeleton().W(el.Dp(48)).H(el.Dp(48)).Circle().Render(cx), kit.Skeleton().W(el.Dp(180)).Shimmer().Render(cx), kit.Skeleton().Shimmer().Render(cx), el.Div().W(el.Dp(240)).MaxW(el.Full).Child(kit.Skeleton().Secondary(true).Render(cx)))
}
return el.Div().P(24).Gap(16).Child(
el.Text(demoText("Skeleton · Loading placeholder", "Skeleton · 加载占位")).Bold(),
el.Text(demoText("Gray blocks reserve space while content loads, reducing layout shifts when it appears.", "灰块表示内容正在加载,不是正文缺失。它们提前占位,减少内容出现时的布局跳动。")),
card,
kit.Button(label, func() { v.loaded = !v.loaded }).Render(cx),
el.Text(demoText("Basic shapes: circle, rounded rectangle, rectangle", "基本形状:圆形、圆角矩形、直角矩形")).TextColor(theme.Muted),
el.Div().Wrap().Gap(16).Child(kit.Skeleton().W(el.Dp(48)).H(el.Dp(48)).Circle().Render(cx), kit.Skeleton().W(el.Dp(120)).H(el.Dp(48)).Rounded(24).Render(cx), kit.Skeleton().W(el.Dp(120)).H(el.Dp(48)).Rounded(0).Render(cx)),
kit.Button(demoText("Toggle reduced motion", "切换减少动画"), func() { theme.SetReducedMotion(!theme.ReducedMotion) }).Render(cx),
)
}
kit.Skeleton().W(el.Dp(240)).H(el.Dp(16)) 创建灰色加载占位,默认铺满宽度、高 16dp。Circle 绘制居中的圆形,常与相同宽高搭配。Shimmer 启用扫光,默认使用明暗脉冲。
动画基于 cx.Now 并通过 cx.AnimatingAmbient 按共用的 30 Hz 节奏请求帧;减少动画时保持静态。Skeleton 是装饰,不暴露 Agent 语义,不处理键盘。Shimmer 是选项,不是独立组件。
验证:go run ./examples/components -section skeleton -theme dark,省略 theme 查看浅色。示例按钮切换减少动画;像素测试注入帧时间验证两种动画及静止状态。
Secondary(true) 将整个占位图形(包括脉冲或扫光)透明度减半,Secondary(false) 恢复。Rounded(dp) 自定义矩形圆角,0 为直角,默认为 RadiusSm;负数、NaN、无穷值忽略,绘制时限制到短边的一半。Rounded 与 Circle 后调用者生效;Circle 在非正方形区域中仍绘制居中圆形。颜色每帧读取主题,减少动画时仍保留圆角与次级色阶。