跳到正文

Avatar 头像 ​

用户头像展示组件,支持图片、文字占位、形状与在线状态指示器。

使用方式 ​

组件以 EmAvatar 为名导出,全局注册后可直接使用:

vue
<template>
  <em-avatar name="张三" :size="40" />
</template>

未提供图片 src 时,根据 name 渲染文字占位头像。

基础用法 ​

在线状态 ​

徽标 ​

API ​

Avatar API ​

Props ​

属性类型默认值说明
srcstring—头像图片地址;为空或加载失败时回退为文字头像(取 name 前 2 个字符)
namestring—用户名,用于生成文字头像内容与背景色
sizenumber40头像尺寸(px),默认 40;文字字号与在线状态指示器随之自适应
shape'circle' | 'square'undefined头像形状:circle(圆形)/ square(圆角方形);不传时跟随主题 avatarShape
presencePresenceDisplayStatus—在线状态,传入则展示右下角指示器(Figma 1994:26192:固定 8px 彩色核心,不随头像缩放;
1.5px 分界环为 mask 镂空,与当地背景融为一体)
presenceSizenumber—指示器总直径(px,含 1.5px 分界环),默认 11(核心 8 + 环 1.5 × 2)
editablebooleanfalse是否可编辑(通常仅当前用户自己的头像使用),点击时触发 presence-click
badgenumber—徽标数字;超过 badgeMax 显示为 "max+";为 0 或未传时不显示(badgeDot 红点模式除外)
badgeDotbooleanfalse徽标红点模式:仅显示小圆点不显示数字,默认 false
badgeMaxnumber99徽标数字显示上限,默认 99
badgePlacementBadgePlacement'top-right'徽标位置:top-right(默认,避开右下角 presence 指示器)/ bottom-right
badgeColorstring'var(--uikit-badge-bg, #FF7070)'徽标颜色,默认 --uikit-badge-bg(#FF7070)

Events ​

事件名参数说明
presence-click—头像为可编辑态(editable)时点击触发,用于唤起更换头像等操作