Skip to content

syncfusion/wpf-ui-components-skills / skills/syncfusion-wpf-avatar-view

syncfusion-wpf-avatar-view

Verified

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.

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:

ContentTypeWhat it Shows
DefaultBuilt-in Avatar1 character, no setup needed
InitialsText initials extracted from AvatarName
CustomImageUser-supplied image via ImageSource
AvatarCharacterOne of 25 pre-built character images
GroupMultiple 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

  • 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

  • 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

  • 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

  • BorderBrush and BorderThickness
  • Background β€” solid color
  • Gradient background β€” LinearGradientBrush / RadialGradientBrush
  • FontFamily, FontSize, Foreground for initials text

Badge Integration

πŸ“„ Read: references/badge-integration.md

  • Attaching SfBadge to SfAvatarView
  • Positioning badge with HorizontalPosition / VerticalPosition
  • Status indicator pattern (online/offline dot)

Quick Start Example

xmlns:syncfusion="http://schemas.syncfusion.com/wpf"

Display initials:

<syncfusion:SfAvatarView ContentType="Initials"
                         AvatarName="Alex"
                         InitialsType="DoubleCharacter"
                         AvatarShape="Circle"
                         AvatarSize="Large" />

Display a custom image:

<syncfusion:SfAvatarView ContentType="CustomImage"
                         AvatarShape="Circle"
                         AvatarSize="Large"
                         ImageSource="pack://application:,,,/Assets/profile.png" />

Display a pre-built character:

<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

PropertyTypePurpose
ContentTypeAvatarContentTypeSelects rendering mode
AvatarNamestringSource for initials extraction
InitialsTypeAvatarInitialsTypeSingle or double character initials
ImageSourceImageSourceImage URI for CustomImage mode
AvatarCharacterAvatarCharacterPre-built character enum (Avatar1–Avatar25)
AvatarShapeAvatarShapeCircle / Square / Custom
AvatarSizeAvatarSizeExtraSmall / Small / Medium / Large / ExtraLarge
GroupSourceIEnumerableData collection for Group mode
ContentTemplateDataTemplateCustom template for avatar content
BorderBrushBrushBorder color
BorderThicknessThicknessBorder width
BackgroundBrushBackground fill (solid or gradient)
CornerRadiusCornerRadiusRounding for Custom shape
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall