# Avatar API

> Auto-generated API reference for `Avatar` from @vuetify/v0 (Vuetify0).
> Source of truth: https://0.vuetifyjs.com/api/avatar

## Related

- https://0.vuetifyjs.com/components/semantic/avatar
- https://0.vuetifyjs.com/components/primitives/atom
- https://0.vuetifyjs.com/components/semantic/image
- https://0.vuetifyjs.com/composables/system/use-image

## Avatar.Root

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `namespace` | `string \| undefined` | `"v0:avatar"` | no | Namespace for dependency injection |
| `value` | `unknown` | — | no | Identifier when used inside Avatar.Group; harmless when standalone |
| `disabled` | `boolean \| undefined` | `false` | no | Disables this avatar's contribution to group capacity math |
| `groupNamespace` | `string \| undefined` | `"v0:avatar:group"` | no | Namespace of the parent Avatar.Group context |

### Slots

| Name | Type | Description |
|---|---|---|
| `default` | `AvatarRootSlotProps` | — |

## Avatar.Fallback

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `namespace` | `string \| undefined` | `"v0:avatar"` | no | Namespace for retrieving avatar context |

### Slots

| Name | Type | Description |
|---|---|---|
| `default` | `AvatarFallbackSlotProps` | — |

## Avatar.Group

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `namespace` | `string \| undefined` | `"v0:avatar:group"` | no | Namespace for dependency injection (must match Avatar.Root groupNamespace) |
| `max` | `number \| undefined` | — | no | Upper bound on visible count; default Infinity |
| `responsive` | `boolean \| undefined` | `false` | no | Opt-in width-responsive truncation via createOverflow |
| `priority` | `AvatarGroupPriority \| undefined` | `"start"` | no | Which side keeps items when truncated |
| `gap` | `number \| undefined` | `0` | no | Pixel gap between items; only meaningful when responsive |
| `label` | `string \| undefined` | — | no | Accessible name for the group |
| `ariaLabelledby` | `string \| undefined` | — | no | ID of element that labels this group |
| `ariaDescribedby` | `string \| undefined` | — | no | ID of element that describes this group |

### Slots

| Name | Type | Description |
|---|---|---|
| `default` | `AvatarGroupSlotProps` | — |

## Avatar.Image

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `src` | `string \| undefined` | — | no | Image source URL |
| `alt` | `string \| undefined` | — | no | Accessible alt text. |
| `priority` | `number \| undefined` | `0` | no | Priority for display order (higher = more preferred) |
| `namespace` | `string \| undefined` | `"v0:avatar"` | no | Namespace for retrieving avatar context |

### Events

| Name | Type | Description |
|---|---|---|
| `load` | `[e: Event]` | — |
| `error` | `[e: Event]` | — |

### Slots

| Name | Type | Description |
|---|---|---|
| `default` | `AvatarImageSlotProps` | — |

## Avatar.Indicator

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `namespace` | `string \| undefined` | `"v0:avatar:group"` | no | Namespace of the parent Avatar.Group context |

### Slots

| Name | Type | Description |
|---|---|---|
| `default` | `AvatarIndicatorSlotProps` | — |