syncfusion/wpf-ui-components-skills / skills/syncfusion-wpf-avatar-view
syncfusion-wpf-avatar-view
VerifiedImplement Syncfusion WPF SfAvatarView for displaying user profile avatars and initials. Use this when working with avatar controls, user profile displays, group avatars, or badge integration in WPF. Covers all content types (Default, Initials, CustomImage, AvatarCharacter, Group, ContentTemplate), visual styles (Circle, Square, custom shape/size), appearance customization, and SfBadge integration.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.9 KB |
| references/badge-integration.md | markdown | 3.3 KB |
| references/content-types.md | markdown | 6.4 KB |
| references/customization.md | markdown | 4.7 KB |
| references/getting-started.md | markdown | 2.2 KB |
| references/visual-styles.md | markdown | 5.3 KB |
SKILL.md
View on GitHub---
name: syncfusion-wpf-avatar-view
description: Implement Syncfusion WPF SfAvatarView for displaying user profile avatars and initials. Use this when working with avatar controls, user profile displays, group avatars, or badge integration in WPF. Covers all content types (Default, Initials, CustomImage, AvatarCharacter, Group, ContentTemplate), visual styles (Circle, Square, custom shape/size), appearance customization, and SfBadge integration.
metadata:
author: "Syncfusion Inc"
version: "34.1.29"
---
# Implementing SfAvatarView (WPF)
## When to Use This Skill
Use this skill when the user needs to:
- Display a user profile picture, initials, or avatar character
- Show text initials (single or double character) with a colored background
- Use pre-built avatar characters (Avatar1βAvatar25)
- Build a group avatar view from a data collection
- Customize avatar shape (Circle, Square, Custom) and size
- Apply borders, backgrounds, gradients, or font styling to an avatar
- Attach a badge (status indicator) to an avatar
**Component:** `SfAvatarView`
**Assembly:** `Syncfusion.Shared.WPF`
**XAML Namespace:** `xmlns:syncfusion="http://schemas.syncfusion.com/wpf"`
---
## Component Overview
`SfAvatarView` displays a user avatar in one of five content modes:
| ContentType | What it Shows |
|---|---|
| `Default` | Built-in Avatar1 character, no setup needed |
| `Initials` | Text initials extracted from `AvatarName` |
| `CustomImage` | User-supplied image via `ImageSource` |
| `AvatarCharacter` | One of 25 pre-built character images |
| `Group` | Multiple avatars from a bound collection |
Shape is controlled by `AvatarShape` (Circle / Square / Custom). Size by `AvatarSize` (ExtraSmall β ExtraLarge).
---
## Documentation and Navigation Guide
### Getting Started
π **Read:** [references/getting-started.md](references/getting-started.md)
- NuGet package and assembly setup
- XAML namespace declaration
- Minimal working example (Default type)
- ImageSource quick start
- Required CSS/theme imports
### Content Types
π **Read:** [references/content-types.md](references/content-types.md)
- `Default` β zero-config avatar character
- `Initials` β `AvatarName` + `InitialsType` (Single/Double)
- `CustomImage` β `ImageSource` with pack:// URI
- `AvatarCharacter` β Avatar1βAvatar25 enum
- `Group` view β `GroupSource` + member path properties + ViewModel pattern
- `ContentTemplate` β fully custom DataTemplate rendering
### Visual Styles
π **Read:** [references/visual-styles.md](references/visual-styles.md)
- `AvatarShape`: Circle (default), Square, Custom
- `AvatarSize`: ExtraSmall, Small, Medium, Large, ExtraLarge
- Custom shape β explicit Height, Width, CornerRadius, FontSize
- Style reuse via WPF ResourceDictionary
### Customization
π **Read:** [references/customization.md](references/customization.md)
- `BorderBrush` and `BorderThickness`
- `Background` β solid color
- Gradient background β `LinearGradientBrush` / `RadialGradientBrush`
- `FontFamily`, `FontSize`, `Foreground` for initials text
### Badge Integration
π **Read:** [references/badge-integration.md](references/badge-integration.md)
- Attaching `SfBadge` to `SfAvatarView`
- Positioning badge with `HorizontalPosition` / `VerticalPosition`
- Status indicator pattern (online/offline dot)
---
## Quick Start Example
```xml
xmlns:syncfusion="http://schemas.syncfusion.com/wpf"
```
**Display initials:**
```xml
<syncfusion:SfAvatarView ContentType="Initials"
AvatarName="Alex"
InitialsType="DoubleCharacter"
AvatarShape="Circle"
AvatarSize="Large" />
```
**Display a custom image:**
```xml
<syncfusion:SfAvatarView ContentType="CustomImage"
AvatarShape="Circle"
AvatarSize="Large"
ImageSource="pack://application:,,,/Assets/profile.png" />
```
**Display a pre-built character:**
```xml
<syncfusion:SfAvatarView ContentType="AvatarCharacter"
AvatarCharacter="Avatar5"
AvatarShape="Circle"
AvatarSize="Medium" />
```
---
## Common Patterns
**Pattern 1 β Pick content type based on available data:**
- Have a profile image URL β `ContentType="CustomImage"` + `ImageSource`
- Have a name string β `ContentType="Initials"` + `AvatarName`
- Need a placeholder β `ContentType="AvatarCharacter"` + choose Avatar1βAvatar25
- Need fully custom UI inside the avatar β `ContentTemplate` with `DataTemplate`
**Pattern 2 β Group avatar from a list:**
- Bind a collection β `ContentType="Group"` + `GroupSource`
- Map member paths: `InitialsMemberPath`, `ImageSourceMemberPath`, `BackgroundColorMemberPath`, `InitialsColorMemberPath`
**Pattern 3 β Shape + size selection:**
- Profile card with circular avatar β `AvatarShape="Circle"` + `AvatarSize` enum
- Square tile avatar β `AvatarShape="Square"` + `AvatarSize` enum
- Fully custom dimensions β `AvatarShape="Custom"` + explicit `Height`/`Width`/`CornerRadius`
---
## Key Props Reference
| Property | Type | Purpose |
|---|---|---|
| `ContentType` | `AvatarContentType` | Selects rendering mode |
| `AvatarName` | `string` | Source for initials extraction |
| `InitialsType` | `AvatarInitialsType` | Single or double character initials |
| `ImageSource` | `ImageSource` | Image URI for CustomImage mode |
| `AvatarCharacter` | `AvatarCharacter` | Pre-built character enum (Avatar1βAvatar25) |
| `AvatarShape` | `AvatarShape` | Circle / Square / Custom |
| `AvatarSize` | `AvatarSize` | ExtraSmall / Small / Medium / Large / ExtraLarge |
| `GroupSource` | `IEnumerable` | Data collection for Group mode |
| `ContentTemplate` | `DataTemplate` | Custom template for avatar content |
| `BorderBrush` | `Brush` | Border color |
| `BorderThickness` | `Thickness` | Border width |
| `Background` | `Brush` | Background fill (solid or gradient) |
| `CornerRadius` | `CornerRadius` | Rounding for Custom shape |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |