Avatar

Adds additional visual information about a user.

When to use

  • When you want to show a user's image along contextual information.
  • When you want to attribute an action to a user.

Accessibility

  • Top level name prop will be set on the <img> element as its alt attribute.
  • If src fails to load, applies aria-label with provided name and role with 'img' to root div element.

Avatar with available sizes

user
user
user
user
user

Avatar with error fallback

user
user
user
user
user

Avatar with initals

Avatar with example overrides

user name #1
beyonce knowles
user name #3
beyonce knowles

Overrides

Additionally, you can fully customize any part of the Avatar through the overrides prop. The Avatar consists of multiple subcomponents that are listed bellow and you can override each one of them. To help you identify the names of these subcomponents, you can highlight them through this selector:

user name #1
user

Note: You should always use longhand CSS properties. Mixing shorthands and longhands will lead into strange behaviors!

Avatar API

Warning any = "Prop types are not shown in dev mode"

extract-react-types is not being run in dev mode for speed reasons. If you need to see prop types add the environment variable FORCE_EXTRACT_REACT_TYPES eg:

  • FORCE_EXTRACT_REACT_TYPES=true yarn start <packageName>
  • FORCE_EXTRACT_REACT_TYPES=true yarn start:<team>