C

AvatarGroup 头像组

业务组件

多个头像堆叠展示,显示剩余数量 +N。

何时使用

需要头像组功能时使用本组件。

代码示例

基础用法

tsx
import { AvatarGroup } from "@/components/business/avatar-group"

export function Basic() {
return <AvatarGroup />
}

API / Props

AvatarGroup

PropTypeDefault说明
classNamestring自定义样式类名
usersAvatarUser[]
maxnumber4最大值
size"sm" | "default" | "lg" | "xl"default组件尺寸
showOverflowbooleantrue
onOverflowClick() => void
...restReact.ComponentProps<"div">透传 <div> 原生属性

注意事项

  • Client Component: 使用 "use client",依赖 React hooks/状态,需在客户端渲染。
  • 原生属性: 继承所有 <div> 原生 HTML 属性。

📘 完整交互式示例与控件属性请查看 Storybook 文档