Keel v0.5.1 English GitHub

AvatarGroup

在线示例:这是真实的 Keel 程序编译成 WebAssembly,可以直接操作。首次加载约 10 MB。全屏打开
示例代码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 查看深色。