数据展示/头像

Avatar 头像

Avatar 头像用于展示用户的头像、图标或状态指示器,支持多种尺寸。

头像尺寸

头像支持多种标准尺寸,始终保持 1:1 比例,圆角为尺寸的 25%。

size 可选:16 18 20 24 28 32 36 38 40 44 46 48 60 70 80 120 160

头像样式

支持图片头像和文字头像两种形式。

src:图片地址,设置后显示图片头像。

text:文本内容,设置后显示文字头像(取首字符)。

在线状态

头像支持显示在线状态指示器(圆形或手机图标)。

status 可选:on(在线) inv(隐身) dnd(勿扰) mo(手机在线)。

带数字徽标头像

头像可与数字徽标组合使用,显示数量提醒。

组合头像

多人头像按基础组件规范自动切片展示,支持 2-9 个头像。

API 参考

参数 说明 类型 可选值 默认值
src 头像图片地址 string - ''
text 头像文字(取首字符) string - ''
size 头像尺寸,带 status 时仅支持 80 | 48 | 46 | 40 | 36 | 32 | 24 number 16 | 18 | 20 | 24 | 28 | 32 | 36 | 38 | 40 | 44 | 46 | 48 | 60 | 70 | 80 | 120 | 160 40
status 在线状态类型,带状态时头像使用 SVG 蒙版,仅 size 为 80/48/46/40/36/32/24 时可用 string 'on' | 'inv' | 'dnd' | 'mo' null
avatars 组合头像数据,传给 createAvatarGroup,包含 src、text object[] 2-9 项 []
max 组合头像最多展示数量 number 2-9 9