Avatar

Beta

Use avatars to represent users or organizations.

View source View storybook

On this page

Accessibility
Arguments
Examples

Avatar can be used to represent users and organizations on GitHub.

Use the default circle avatar for users, and the square shape for organizations or any other non-human avatars.
By default, Avatar will render a static <img>. To have Avatar function as a link, set the href which will wrap the <img> in a <a>.
Set size to update the height and width of the Avatar in pixels.
To stack multiple avatars together, use AvatarStack.

Accessibility

Images should have text alternatives that describe the information or function represented. If the avatar functions as a link, provide alt text that helps convey the function. For instance, if Avatar is a link to a user profile, the alt attribute should be @kittenuser profile rather than @kittenuser. Learn more about best image practices (WAI Images)

Arguments

Name	Type	Default	Description
`src`	`String`	N/A	The source url of the avatar image.
`alt`	`String`	N/A	Passed through to alt on img tag.
`size`	`Integer`	`20`	One of `16`, `20`, `24`, `32`, `40`, `48`, or `80`.
`shape`	`Symbol`	`:circle`	Shape of the avatar. One of `:circle` and `:square`.
`href`	`String`	`nil`	The URL to link to. If used, component will be wrapped by an `<a>` tag.
`system_arguments`	`Hash`	N/A	System arguments

Examples

Default

<%= render(Primer::Beta::Avatar.new(src: "http://placekitten.com/200/200", alt: "@kittenuser")) %>

Square

<%= render(Primer::Beta::Avatar.new(src: "http://placekitten.com/200/200", alt: "@kittenuser", shape: :square)) %>

Link

<%= render(Primer::Beta::Avatar.new(href: "#", src: "http://placekitten.com/200/200", alt: "@kittenuser profile")) %>

With size

<%= render(Primer::Beta::Avatar.new(src: "http://placekitten.com/200/200", alt: "@kittenuser", size: 16)) %>
<%= render(Primer::Beta::Avatar.new(src: "http://placekitten.com/200/200", alt: "@kittenuser", size: 20)) %>
<%= render(Primer::Beta::Avatar.new(src: "http://placekitten.com/200/200", alt: "@kittenuser", size: 24)) %>
<%= render(Primer::Beta::Avatar.new(src: "http://placekitten.com/200/200", alt: "@kittenuser", size: 32)) %>
<%= render(Primer::Beta::Avatar.new(src: "http://placekitten.com/200/200", alt: "@kittenuser", size: 40)) %>
<%= render(Primer::Beta::Avatar.new(src: "http://placekitten.com/200/200", alt: "@kittenuser", size: 48)) %>
<%= render(Primer::Beta::Avatar.new(src: "http://placekitten.com/200/200", alt: "@kittenuser", size: 80)) %>

Edit this page on GitHub