Avatar 头像

用于展示用户头像信息,支持图片、文字、图标,以及头像组等多种形态。

基础用法
通过 src 设置图片地址,通过 alt 设置首字母缩写,或通过默认插槽传入自定义内容:
张三李四N
不同尺寸
提供 xs / sm / md / lg / xl 五种预设尺寸,也支持传入数字自定义大小:
XSSMMDLGXL80
形状
通过 shape 设置头像形状:circle(圆形)、square(方形)、rounded(圆角方形):
圆方圆角
自定义背景色
通过 color 属性设置头像背景色,适用于文字头像:
ABCDEF
边框头像
设置 bordered 属性在头像周围添加白色边框,常用于头像组中区分重叠的头像:
边框边框N
图片填充模式
通过 fit 属性设置图片填充方式,等同于 CSS object-fit 属性:
covercover
containcontain
fillfill
nonenone
在线状态指示器
通过 show-indicator 显示在线状态点,indicator-status 设置状态:online / offline / busy / away,indicator-position 设置位置:
在线在线
离线离线
忙碌忙碌
离开离开
指示器位置
通过 indicator-position 设置指示器位置:top-right / top-left / bottom-right / bottom-left:
右上右上
左上左上
左下左下
右下右下
头像组
使用 NAvatarGroup 组合多个头像,支持设置最大显示数量和方向:

默认头像组

张三李四

不同尺寸

ABC
结合徽标
搭配 NBadge 组件展示未读消息数等信息:
消息5通知99N
组合用法
在卡片等容器中使用头像,构建用户信息展示:
张三
张三
前端工程师 · 在线

热爱开源,专注于 Vue 生态和组件库开发。

Avatar Props

参数类型默认值说明
srcstring图片地址
altstring图片替代文本,也用于生成首字母缩写(支持双字名如"张三"→"张三"两字首字母)
size'xs' | 'sm' | 'md' | 'lg' | 'xl' | number'md'尺寸
shape'circle' | 'square' | 'rounded''circle'形状
roundbooleantrue是否为圆形(兼容旧版本,推荐使用 shape)
fit'fill' | 'contain' | 'cover' | 'none' | 'scale-down''cover'图片填充模式,等同于 CSS object-fit
colorstring自定义背景色
borderedbooleanfalse是否显示边框
fallbackstring图片加载失败时的备用地址
show-indicatorbooleanfalse是否显示在线状态指示器
indicator-status'online' | 'offline' | 'busy' | 'away''online'指示器状态
indicator-position'top-right' | 'top-left' | 'bottom-right' | 'bottom-left''bottom-right'指示器位置

Avatar Events

事件名参数说明
load(e: Event)图片加载成功时触发
error(e: Event)图片加载失败时触发

Avatar Slots

插槽名说明
default自定义头像内容(图片加载失败或无 src 时显示)

AvatarGroup Props

参数类型默认值说明
size'xs' | 'sm' | 'md' | 'lg' | 'xl' | number'md'统一设置组内头像尺寸
shape'circle' | 'square' | 'rounded''circle'统一设置组内头像形状
colorstring统一设置组内文本头像背景色
borderedbooleantrue是否显示边框(头像组默认开启)
maxnumberInfinity最大显示头像数量
direction'left' | 'right''left'头像排列方向
closablebooleanfalse是否可关闭