AvatarGroup 头像组
业务组件
多个头像堆叠展示,显示剩余数量 +N。
何时使用
需要头像组功能时使用本组件。
代码示例
基础用法
tsx
import { AvatarGroup } from "@/components/business/avatar-group"
export function Basic() {
return <AvatarGroup />
}API / Props
AvatarGroup
| Prop | Type | Default | 说明 |
|---|---|---|---|
className | string | — | 自定义样式类名 |
users | AvatarUser[] | — | |
max | number | 4 | 最大值 |
size | "sm" | "default" | "lg" | "xl" | default | 组件尺寸 |
showOverflow | boolean | true | |
onOverflowClick | () => void | — | |
| ...rest | React.ComponentProps<"div"> | — | 透传 <div> 原生属性 |
注意事项
- Client Component: 使用
"use client",依赖 React hooks/状态,需在客户端渲染。 - 原生属性: 继承所有
<div>原生 HTML 属性。
📘 完整交互式示例与控件属性请查看 Storybook 文档。