项目正在快速迭代中,API 与视觉细节可能随版本调整,请勿用于生产环境。
双端兼容 · 桌面 + 移动

Avatar 头像 ​

头像组件:支持图片地址(加载失败自动回退到默认插槽)、文字内容与三档尺寸,圆形与方形两种形状;AvatarGroup 将相邻头像叠放显示,并统一向子头像注入 size / shape。头像也可与 Badge 组合显示未读数。

基础用法 ​

size 传数字时按像素渲染(宽高与行高同步),传 small / default / large 走三档(24 / 40 / 56px);shape="square" 切换方形。

用户头像
W
W

文字头像 ​

无 src 时直接渲染默认插槽内容,可通过样式定制底色与字号,常用于姓名首字、团队名。

W
wil
团队

加载失败回退 ​

src 加载失败(onerror)时自动切换为默认插槽内容;未提供插槽则显示为空白底。alt 与 srcSet 透传给 img。

加载失败示例

头像组叠放 ​

AvatarGroup 统一注入 size 与 shape,相邻头像自动叠放并带背景描边;组内末尾常放置计数头像(如 +3)表示更多成员。

+3

组内单项覆盖 ​

子头像显式指定 size(非 default)时以子头像为准,可突出关键成员;shape 则由组统一决定,子级设置会被组覆盖。

与徽标组合 ​

头像与 Badge 组合展示未读数或在线状态,Badge 自动定位到头像右上角。

6
WTOP

API ​

Avatar Props

参数说明类型默认值
size尺寸,数字按像素,否则走三档(24 / 40 / 56px)number | small | default | largedefault
src图片地址,加载失败时回退到默认插槽string
srcSet图片 srcset,透传给 imgstring
alt图片描述文本,透传给 imgstring
shape形状(组内会被 AvatarGroup 的 shape 覆盖)circle | squarecircle
icon预留图标名(当前版本未参与渲染)string

AvatarGroup Props

参数说明类型默认值
size统一注入子头像的尺寸(子头像显式指定非 default 尺寸时以子头像为准)number | small | default | largedefault
shape统一注入子头像的形状(优先于子头像自身设置)circle | squarecircle

Avatar Slots

参数说明类型默认值
default无图或加载失败时的回退内容——