AvatarGroup
示例代码Go · 可复制
这是上方组件库展示案例的完整源码。examples/components/avatar_group.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("avatar_group", "display", func() core.Widget {
avatars := []*kit.AvatarView{kit.Avatar(demoText("Alex Chen", "张三")).Status(kit.AvatarOnline), kit.Avatar("Ada Lovelace"), kit.Avatar("Bob"), kit.Avatar("Carol"), kit.Avatar("Dave")}
small := kit.AvatarGroup(avatars...).Size(24)
limited := kit.AvatarGroup(avatars...).Limit(3)
ellipsis := kit.AvatarGroup(avatars...).Size(56).Limit(2).Ellipsis(true)
return el.Embed(el.ViewFunc(func(cx *el.Context) el.Element {
return el.Div().P(theme.SpaceXl).Gap(theme.SpaceLg).Items(el.Start).Child(
el.Text(demoText("Team members", "团队成员")), small.Render(cx), el.Text(demoText("Show 3 people; represent the rest with a count", "显示 3 人,其余用数量表示")), limited.Render(cx), el.Text(demoText("Ellipsis mode", "省略号模式")), ellipsis.Render(cx))
}))
})
}
把多个头像叠放成成员组,限制可见人数后用 +N 显示隐藏人数。
team := kit.AvatarGroup(
kit.Avatar("张三").Status(kit.AvatarOnline),
kit.Avatar("Ada Lovelace"),
kit.Avatar("Bob"),
).Size(40).Limit(2)
Size(dp) 统一组内直径,默认 40dp,限制在 16–256dp;不修改成员头像自身尺寸。头像重叠四分之一,外圈使用 2dp theme.Outline 描边。窄窗口提供横向滚动。
Limit(n) 限制实际显示的头像数量,溢出标记另外占一格。默认负数表示不限,0 只显示总隐藏人数。Ellipsis(true) 把可见的 +N 换成省略号,Agent 仍可读取隐藏人数。
SetAvatars 复制成员切片并过滤 nil;Avatars() 返回切片副本,头像实例仍然共享,可以继续更新姓名、图片和状态。空组不占高度。
Agent:外层为 group,可见成员为 avatar,保留原姓名和状态;溢出头像名称为本地化的“更多 N”,value 为隐藏人数。组为展示内容,不占用键盘焦点。
验证:go run ./examples/components -section avatar_group,加 -theme dark 查看深色。