Angular Avatar Component | ng-hub-ui-avatar
Angular avatar component with initials, fallback images, presence badges and CSS variables for reusable user identity interfaces.
Interactive examples
Explore live examples that show how the library behaves in common Angular use cases.
Avatar Sources
Resolve avatars from social profiles, custom images, name initials or a custom value, with automatic fallback.
Facebook Profile
Gravatar
GitHub Profile
Custom Image Source
Name Initials
Value Display
Fallback System
Gracefully degrade through every configured source until a meaningful representation is shown.
Fallback System
Showing GitHub source (Facebook ID invalid)
Sizing
Control avatar dimensions, the text-to-size ratio and how many initials are rendered.
Custom Size
3.5remcalc(2rem + 12px)72 (pixels)Text Size Ratio
Initials Size Limit
Styling
Shape, corner radius, colours, borders and arbitrary inline styles — all driven by inputs and CSS variables.
Round Avatar
Corner Radius
Background & Foreground Color
--hub-avatar-bg-color ([autoColor]="false")Contrast-safe initials
The automatic palette, as it paints today
Eight names, one per palette slot. Each avatar writes black or white on the colour its name hashed to, and the first ratio below it is read back from the two colours the browser actually painted. The second is what white initials would have scored on that same colour — what the component forced before 22.14.0, and what six of these eight would still be doing.
- GHmeasuring…
- ALmeasuring…
- LTmeasuring…
- BLmeasuring…
- DKmeasuring…
- ATmeasuring…
- KTmeasuring…
- ABmeasuring…
Those six are stated rather than shown on purpose: a row of white-on-yellow initials would be a page about readable labels printing six unreadable ones. An explicit fgColor does still win, contrast or not — that is how you pin the old look, and the snippet below is all it takes.
A palette the library has never seen
#ffcc00, #cccccc and #004080 — three colours the library ships no knowledge of. An application hands them to provideAvatar({ colors }) once at bootstrap; this demo scopes the same palette to its own avatars so it does not repaint the rest of the page. Either way the ink is derived from whatever colour ends up behind the text, so the guarantee travels with the background rather than with a list of approved pairings.
- VRmeasuring…
- INmeasuring…
- RPmeasuring…
Border Color
Custom Styles
Interactivity
React to user interaction with the avatar click event.
Click Event Handler
Groups & badge
Stack avatars into a group, and overlay a corner badge — a presence dot or a labelled count — coloured by the semantic palette.
Avatar Group Display
Badge (dot & count)
Custom content
Project any icon, inline SVG, image or emoji inside the avatar. It is centered, padded and clipped to the avatar shape, sized agnostically (font icons scale, SVG/images fill) and themed with the regular bgColor / fgColor inputs.
Custom content (icons, SVG)