头像组
使用方法
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 等尺寸,整个组一起缩放,头像之间的重叠比例保持一致。