Avatar 头像

头像类型

头像提供了 3 种不同类型的头像:图标头像、图片头像、字符头像

W

头像形状

头像默认支持两种形状:round、circle,用户也可自定义设置头像形状

W
W

头像大小

头像默认支持三种大小:small、medium、large,用户可自定义设置大小

W
W
W
W
W
W
W
W

字符头像大小自适应

头像支持字符自适应,即字符长度过长时,头像可自动调整字符以便呈现完整内容

王亿
王亿亿

组合头像

组合头像展现

W
W

组合头像偏移方向

组合头像可控制层叠方向

W
W

组合头像个数

组合头像可设置最大展示个数,超过则隐藏显示

Avatar
+1
Avatar
Avatar
more

Avatar Props

名称类型默认值说明必传
altString-头像替换文本,仅当图片加载失败时有效N
contentString / Slot / Function-子元素内容。TS 类型:string | TNode通用类型定义N
defaultString / Slot / Function-子元素内容,同 content。TS 类型:string | TNode通用类型定义N
hideOnLoadFailedBooleanfalse加载失败时隐藏图片N
iconSlot / Function-图标。TS 类型:TNode通用类型定义N
imageString-图片地址N
imagePropsObject-透传至 Image 组件。TS 类型:ImagePropsImage API Documents详细类型定义N
shapeStringcircle形状。可选项:circle/round。TS 类型:ShapeEnum type ShapeEnum = 'circle' | 'round'详细类型定义N
sizeString-尺寸,示例值:small/medium/large/24px/38px 等。优先级高于 AvatarGroup.size 。Avatar 单独存在时,默认值为 medium。如果父组件存在 AvatarGroup,默认值便由 AvatarGroup.size 决定N
onErrorFunctionTS 类型:(context: { e: Event }) => void
图片加载失败时触发
N

Avatar Events

名称参数描述
error(context: { e: Event })图片加载失败时触发

AvatarGroup Props

名称类型默认值说明必传
cascadingString'right-up'图片之间的层叠关系,可选值:左侧图片在上和右侧图片在上。可选项:left-up/right-up。TS 类型:CascadingValue type CascadingValue = 'left-up' | 'right-up'详细类型定义N
collapseAvatarString / Slot / Function-头像数量超出时,会出现一个头像折叠元素。该元素内容可自定义。默认为 +N。示例:+5..., 更多。TS 类型:string | TNode通用类型定义N
maxNumber-能够同时显示的最多头像数量N
popupPropsObject-头像右上角提示信息。TS 类型:PopupPropsPopup API Documents详细类型定义N
sizeStringmedium尺寸,示例值:small/medium/large/24px/38px 等。优先级低于 Avatar.sizeN

何时使用

需要展示用户的个性化信息、或者站点、项目、作品等的识别标示。

组件搭配使用

与导航组合使用,通常会搭配单行文字或单个图标,用于识别身份信息、登录信息。
与列表组合使用,可搭配多行文字,用于展示结构化的成员名称及信息,方便快速识别。
可与徽标数字组合展示,可作为消息提示或人员数量提示等。

常见用法

多个头像可组合展示构成头像组,叠加展示。当页面布局空间有限,超过可外显个数时候,可将重复性较高的头像信息做隐藏收起,需要时再让用户主动触发查看。
图示:多个头像组合
图示:当超过外显个数时,可使用浮窗展示完整的头像列表

推荐/慎用示例

对于字符型头像,需要根据场景定义最大字符数,避免字符过多影响可读性,降低可识别度。

使用多个头像组合时,需根据场景和信息类型定义最长数量,避免数值过多影响可读性,降低使用效率。

当需要点击头像进行操作时,应使用操作按钮,且放置在头像组合上,避免将行动按钮放置在组合下方造成点击不便,表意不明。
  • circle
  • round