Avatar
Represents a person or an account with their picture, or with their initials when there is no picture.
Initials and image
Initials are the default. With
image_href
, the picture replaces them once it loads.
MF
PP
<.avatar id="avatar-initials" name="Marek Fořt" color="blue" />
<.avatar
id="avatar-image"
name="Pedro Piñera"
image_href="/marketing/images/noora/pedro.png"
image_alt="Pedro Piñera"
/>
Sizes
Medium is the default. Use the smaller sizes in tables and menus, and the larger ones on profile pages.
A
AM
AM
AM
AM
AM
<.avatar id="avatar-size-2xsmall" name="Asmit Malakannawar" size="2xsmall" color="purple" />
<.avatar id="avatar-size-small" name="Asmit Malakannawar" size="small" color="purple" />
<.avatar id="avatar-size-medium" name="Asmit Malakannawar" size="medium" color="purple" />
<.avatar id="avatar-size-large" name="Asmit Malakannawar" size="large" color="purple" />
<.avatar id="avatar-size-xlarge" name="Asmit Malakannawar" size="xlarge" color="purple" />
<.avatar id="avatar-size-2xlarge" name="Asmit Malakannawar" size="2xlarge" color="purple" />
Colors
Purple is the default. Each color helps tell accounts apart in a list.
T
RL
OM
YP
GL
AA
BH
PS
PP
<.avatar id="avatar-color-gray" name="Tuist" color="gray" />
<.avatar id="avatar-color-red" name="Rover Labs" color="red" />
<.avatar id="avatar-color-orange" name="Orbit Mobile" color="orange" />
<.avatar id="avatar-color-yellow" name="Yellow Pages" color="yellow" />
<.avatar id="avatar-color-green" name="Green Ledger" color="green" />
<.avatar id="avatar-color-azure" name="Azure Apps" color="azure" />
<.avatar id="avatar-color-blue" name="Blue Harbor" color="blue" />
<.avatar id="avatar-color-purple" name="Purple Studio" color="purple" />
<.avatar id="avatar-color-pink" name="Pink Pixel" color="pink" />
Name formats
Single words give one initial. Handles split on hyphens and underscores.
T
IP
RB
MD
<.avatar id="avatar-name-single" name="tuist" color="gray" />
<.avatar id="avatar-name-hyphen" name="ios-platform-team" color="azure" />
<.avatar id="avatar-name-underscore" name="release_bot" color="orange" />
<.avatar id="avatar-name-three-words" name="Mobile Developer Experience" color="green" />
Placeholder
With
fallback="placeholder"
, an animated dither texture replaces the initials.
<.avatar id="avatar-placeholder-small" name="Unknown author" fallback="placeholder" size="small" />
<.avatar id="avatar-placeholder-medium" name="Unknown author" fallback="placeholder" />
<.avatar id="avatar-placeholder-large" name="Unknown author" fallback="placeholder" size="large" />
Guidelines
-
Always pass the account's
name. It produces the initials and stays the fallback when the image is missing or fails to load. -
Initials come from the first letters of the first two words of the name, split on spaces, hyphens, underscores, and commas. The
2xsmallsize shows one initial. -
Keep the
colorstable for each account. The dashboard derives it from the account name withAccounts.avatar_color/1, so the same account always gets the same color. -
Give every avatar a unique
id. TheNooraAvatarhook that swaps between the image and the fallback needs it. -
Pass
image_alt=""when the name is already written next to the avatar, so screen readers do not announce it twice.
API reference
<.avatar>
| Attribute | Type | Default | Description |
|---|---|---|---|
|
color
|
string
|
"purple"
|
The color of the avatar.
"gray""red""orange""yellow""green""azure""blue""purple""pink"
|
|
fallback
|
string
|
"initials"
|
Determines the fallback for when an image is not available. Can be either initials or a placeholder image
"initials""placeholder"
|
|
id
Required
|
string
|
–
|
The unique identifier for the avatar.
|
|
image_alt
|
string
|
nil
|
Alternative text for the avatar image. Pass an empty string where the person's name is already rendered beside the avatar, so assistive technology does not announce it twice. Leave unset for avatar-only controls, which still need an accessible name of their own.
|
|
image_decoding
|
string
|
"async"
|
The image decoding strategy to use when rendering an avatar image.
"sync""async""auto"
|
|
image_href
|
string
|
nil
|
The URL of the image to render as the avatar.
|
|
image_loading
|
string
|
nil
|
The loading strategy to use when rendering an avatar image.
|
|
name
Required
|
string
|
–
|
The name of the account to render the avatar for.
|
|
on_status_change
|
string
|
nil
|
Event handler for when the status of the avatar changes.
|
|
size
|
string
|
"medium"
|
The size of the avatar. Defaults to medium.
"2xsmall""small""medium""large""xlarge""2xlarge"
|
Also accepts global attributes.