AvatarGroup

叠放多个头像并显示溢出数量。

实时预览

正在加载预览…

参数配置

全部字段 7

AvatarGroupItems

列表项 · 3
AvatarItem
AvatarOptions
Styles · 0
AvatarItem
AvatarOptions
Styles · 0
AvatarItem
AvatarOptions
Styles · 0

AvatarGroupOptions

Styles · 0

Go 代码

Go
// Inside a view; c is *ui.Context, t is nui.Theme.
nui.AvatarGroup(c.Key("avatars"), t, []nui.AvatarItem{{ID: "ada", Avatar: nui.AvatarOptions{Alt: "Ada Lovelace"}}, {ID: "grace", Avatar: nui.AvatarOptions{Alt: "Grace Hopper"}}, {ID: "lin", Avatar: nui.AvatarOptions{Alt: "Lin Chen"}}}, nui.AvatarGroupOptions{Max: nui.Set(2), Size: nui.SizeDefault, Color: nui.ColorDefault})

使用说明

示例用三个稳定 ID 的用户展示头像叠放。修改 maximum 观察可见头像与溢出数量，动态列表应继续使用用户 ID，而不是列表索引。

API 参考

AvatarGroup

源码 
func AvatarGroup(c *ui.Context, t Theme, items []AvatarItem, opts AvatarGroupOptions) ui.Element

AvatarGroupOptions

源码 
type AvatarGroupOptions struct {
	Max     Optional[int]
	Size    Size
	Color   Color
	Overlap Optional[float32]
	Decoration
}
字段类型说明
MaxOptional[int]

Go 零值: unset

上界或数量上限，具体含义依组件而定。

SizeSize

Go 零值: SizeDefault

组件尺寸；默认值继承主题或组件尺寸。

ColorColor

Go 零值: ColorDefault

语义颜色；默认值继承主题或组件配色。

OverlapOptional[float32]

Go 零值: unset

相邻头像的重叠距离。

UIStyles

Go 零值: zero value

以部件名称为键覆盖外观和间距。

Stylefunc(Slot, ui.Element)

Go 零值: nil

同步配置当前构建的部件；不要保留 Element。