Components, Content
Avatar
A small circle or square that stands for a person, an agent, a channel or a Space.
sizeRRiRiRi
stateRiRiRi
selected · working · both
shape · tone#SpE
channel · Space · my account
stackRTO+2
The avatar is a small circle that stands for a person, an agent or a channel. There is one Avatar primitive, and every other avatar is built on top of it. The preview here is static. Props and accessibility behavior are settled at implementation time.
When to use
| prop | Values | Use |
|---|---|---|
size |
xs 20, sm 24, md 32 (default), lg 40 |
Avatars in one row share one size |
shape |
circle (default), square (corner radius 8) |
People and agents are circles. Channels and Spaces are squares |
src, name |
An image, or the first letter of the name when there is no image | Avatar works out the first letter |
selected |
A selection ring (ring) |
The agent you are looking at now |
working |
A Star at the top right | An agent that is working |
tone |
default, me |
me is an ink fill. Use it only for your own account |
- The surface is
card, the border is 1pxborder, and the text ismuted-foregroundat weight 600. The avatar is not painted with color. AvatarStackis the group that overlaps Avatars. Use it for every overlapping set of avatars.AgentAvatarwraps Avatar and handles only what is specific to agents (image fit, 3D, characters).
Color
Agent and Space colors chosen by the user, and profile photos, are outside the token rules. This is an intended exception. No other avatar background uses primary or a status color.
Markup
<span class="Avatar_avatar">Ri</span>
<span class="Avatar_avatar" data-selected="true">Ri<span class="Avatar_live">…Star…</span></span>
<span class="Avatar_stack"><span class="Avatar_avatar Avatar_avatar--sm">Ri</span><span class="Avatar_avatar Avatar_avatar--sm">Ti</span></span>
Don’t
- Don’t create a new
.avatarin the SCSS of a screen. - Don’t show status with the border color of an avatar. Working is a Star. Everything else is a StatusDot.