Skip to content

Avatar

Represents a person, entity, or object using an image, icon, or text, such as a user photo, initials, or symbolic graphic. Avatars help provide visual context and identity within the interface.

Usage

Use avatars to visually identify users or related entities in lists, profiles, or collaborative features. Choose the appropriate variant based on available data - images for personal recognition, initials or icons as fallbacks.

API Reference

Component attubute(s)

x-h-avatar
x-h-avatar-image
x-h-avatar-fallback

Examples

Default


html
<span x-h-avatar>
  <img x-h-avatar-image src="/logo/harmonia-square.svg" alt="@harmonia" />
  <div x-h-avatar-fallback>HM</div>
</span>

Big avatar


html
<span x-h-avatar class="size-12">
  <img x-h-avatar-image src="/logo/harmonia-square.svg" alt="@harmonia" />
  <div x-h-avatar-fallback>HM</div>
</span>

Text-only


html
<span x-h-avatar>HM</span>

Icon-only


html
<span x-h-avatar aria-label="camera">
  <i role="img" data-lucide="camera"></i>
</span>

Interactive

To make an avatar interactive, use the button HTML element instead of a span.

html
<button x-h-avatar>HM</button>