mirror of
https://github.com/ArthurDanjou/ui.git
synced 2026-01-14 20:19:34 +01:00
105 lines
2.5 KiB
Markdown
105 lines
2.5 KiB
Markdown
---
|
|
title: AvatarGroup
|
|
description: Stack multiple avatars in a group.
|
|
category: element
|
|
links:
|
|
- label: GitHub
|
|
icon: i-simple-icons-github
|
|
to: https://github.com/nuxt/ui/tree/v3/src/runtime/components/AvatarGroup.vue
|
|
---
|
|
|
|
## Usage
|
|
|
|
Wrap multiple [Avatar](/components/avatar) within an AvatarGroup to stack them.
|
|
|
|
::component-code
|
|
---
|
|
prettier: true
|
|
slots:
|
|
default: |
|
|
|
|
<UAvatar src="https://github.com/benjamincanac.png" alt="Benjamin Canac" />
|
|
<UAvatar src="https://github.com/romhml.png" alt="Romain Hamel" />
|
|
<UAvatar src="https://github.com/noook.png" alt="Neil Richter" />
|
|
---
|
|
:u-avatar{src="https://github.com/benjamincanac.png" alt="Benjamin Canac"}
|
|
:u-avatar{src="https://github.com/romhml.png" alt="Romain Hamel"}
|
|
:u-avatar{src="https://github.com/noook.png" alt="Neil Richter"}
|
|
::
|
|
|
|
### Size
|
|
|
|
Use the `size` prop to change the size of all the avatars.
|
|
|
|
::component-code
|
|
---
|
|
prettier: true
|
|
props:
|
|
size: xl
|
|
slots:
|
|
default: |
|
|
|
|
<UAvatar src="https://github.com/benjamincanac.png" alt="Benjamin Canac" />
|
|
<UAvatar src="https://github.com/romhml.png" alt="Romain Hamel" />
|
|
<UAvatar src="https://github.com/noook.png" alt="Neil Richter" />
|
|
---
|
|
:u-avatar{src="https://github.com/benjamincanac.png" alt="Benjamin Canac"}
|
|
:u-avatar{src="https://github.com/romhml.png" alt="Romain Hamel"}
|
|
:u-avatar{src="https://github.com/noook.png" alt="Neil Richter"}
|
|
::
|
|
|
|
### Max
|
|
|
|
Use the `max` prop to limit the number of avatars displayed. The rest is displayed as an `+X` avatar.
|
|
|
|
::component-code
|
|
---
|
|
prettier: true
|
|
props:
|
|
max: 2
|
|
slots:
|
|
default: |
|
|
|
|
<UAvatar src="https://github.com/benjamincanac.png" alt="Benjamin Canac" />
|
|
<UAvatar src="https://github.com/romhml.png" alt="Romain Hamel" />
|
|
<UAvatar src="https://github.com/noook.png" alt="Neil Richter" />
|
|
---
|
|
:u-avatar{src="https://github.com/benjamincanac.png" alt="Benjamin Canac"}
|
|
:u-avatar{src="https://github.com/romhml.png" alt="Romain Hamel"}
|
|
:u-avatar{src="https://github.com/noook.png" alt="Neil Richter"}
|
|
::
|
|
|
|
## Examples
|
|
|
|
### With tooltip
|
|
|
|
Wrap each avatar with a [Tooltip](/components/tooltip) to display a tooltip on hover.
|
|
|
|
:component-example{name="avatar-group-tooltip-example"}
|
|
|
|
### With chip
|
|
|
|
Wrap each avatar with a [Chip](/components/chip) to display a chip around the avatar.
|
|
|
|
:component-example{name="avatar-group-chip-example"}
|
|
|
|
### With link
|
|
|
|
Wrap each avatar with a [Link](/components/link) to make them clickable.
|
|
|
|
:component-example{name="avatar-group-link-example"}
|
|
|
|
## API
|
|
|
|
### Props
|
|
|
|
:component-props
|
|
|
|
### Slots
|
|
|
|
:component-slots
|
|
|
|
## Theme
|
|
|
|
:component-theme
|