Skip to content

头像组

使用方法 ​

AvatarGroup 把多个头像重叠排列成一组,适合展示项目成员、协作者或群聊参与者。放不下的头像交给 AvatarGroupOverflow,它会把剩余人数概括为 +N。

基本用法:

vue
<script setup lang="ts">
import { Avatar, AvatarGroup, AvatarGroupOverflow } from '@astryx-vue/core/AvatarGroup'
</script>

<template>
  <AvatarGroup size="md">
    <Avatar name="Ana Thomas" />
    <Avatar name="Ben Lee" />
    <Avatar name="Carol Davis" />
    <AvatarGroupOverflow :count="5" />
  </AvatarGroup>
</template>

最佳实践 ​

指引实践
推荐在 AvatarGroup 上统一设置 size 和 shape,组内头像会自动继承,不必逐个指定。
推荐只渲染需要直接展示的头像,剩余数量交给 AvatarGroupOverflow 以 +N 概括。
推荐头像数量较多时,优先展示最近活跃或最重要的用户,其余折叠进溢出计数。
避免避免为组内单个头像设置 size 或 shape:在组中这些设置不会生效,统一由 AvatarGroup 控制。
避免避免一次展示过多头像,通常最多展示 3–5 个,其余交给溢出计数器概括,界面更清爽。

示例 ​

基础用法

ATBLCDNT +5

多个头像相互重叠排列,末尾的 +N 概括了未展示的成员数量,适合成员列表和协作场景。

尺寸

ATBLCD +2
ATBLCD +2
ATBLCD +2

AvatarGroup 支持 sm、md、lg 等尺寸,整个组一起缩放,头像之间的重叠比例保持一致。