Keel v0.5.1 English GitHub

Skeleton

在线示例:这是真实的 Keel 程序编译成 WebAssembly,可以直接操作。首次加载约 10 MB。全屏打开
示例代码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 在非正方形区域中仍绘制居中圆形。颜色每帧读取主题,减少动画时仍保留圆角与次级色阶。