- [Popper.js](https://popper.js.org/) `v{{ popperVersionMinor }}` is required for dropdowns (and

components based on dropdown), tooltips, and popovers. `v{{ popperVersion }}` is recommended

'b-avatar': 'src',

'b-avatar': 'src',

'b-avatar': 'src',

'b-avatar': 'src',

Avatars are lightweight functional components, which render inline by default, so that they are

vertically centered beside any adjoining plain text. They also can be used as children of other

components.

The `<b-avatar>` component was added in BootstrapVue version `v2.8.0`.

<template>

<div>

<p>Using stand-alone:<p/>

<div class="mb-4">

<b-avatar></b-avatar>

<b-avatar variant="primary" text="BV"></b-avatar>

<b-avatar variant="info" src="https://placekitten.com/300/300"></b-avatar>

<b-avatar variant="success" icon="people-fill"></b-avatar>

</div>

<p>Using in components (list group) example:<p/>

<b-list-group style="max-width: 300px;">

<b-list-group-item class="d-flex align-items-center">

<b-avatar class="mr-3"></b-avatar>

<span class="mr-auto">J. Circlehead</span>

<b-badge>5</b-badge>

</b-list-group-item>

<b-list-group-item class="d-flex align-items-center">

<b-avatar variant="primary" text="BV" class="mr-3"></b-avatar>

<span class="mr-auto">BootstrapVue</span>

<b-badge>12</b-badge>

</b-list-group-item>

<b-list-group-item class="d-flex align-items-center">

<b-avatar variant="info" src="https://placekitten.com/300/300" class="mr-3"></b-avatar>

<span class="mr-auto">Super Kitty</span>

<b-badge>9</b-badge>

</b-list-group-item>

<b-list-group-item class="d-flex align-items-center">

<b-avatar variant="success" icon="people-fill" class="mr-3"></b-avatar>

<span class="mr-auto">ACME group</span>

<b-badge>7</b-badge>

</b-list-group-item>

</b-list-group>

</div>

</template>

The avatar content can be either a short text string, an image, or an icon. Avatar content defaults

to the [`'person-fill'` icon](/docs/icons) when no other content is specified.

You can specify a short string as the content of an avatar via the `text` prop. The string should be

short (1 to 3 characters), and will be transformed via CSS to be all uppercase. The font size will

be scaled relative to the [`size` prop setting](#sizing).

<template>

<div class="mb-2">

<b-avatar text="BV"></b-avatar>

<b-avatar text="a"></b-avatar>

<b-avatar text="Foo"></b-avatar>

<b-avatar text="BV" size="4rem"></b-avatar>

</div>

</template>

Use the `src` prop to specify a URL of an image to use as the avatar content. The image should have

an aspect ratio of `1:1` (meaning the width and height should be equal), otherwise image aspect

distortion will occur. The image will be scaled up or down to fit withing the avatar's bounding box,

and will be sized to show the avatar's [variant background](#variants) around the edge.

<template>

<div class="mb-2">

<b-avatar src="https://placekitten.com/300/300"></b-avatar>

<b-avatar src="https://placekitten.com/300/300" size="6rem"></b-avatar>

</div>

</template>

**Notes:**

- When using a module bundler and project relative image URLs, please refer to the

[Component img src resolving](/docs/reference/images) reference section for additional details.

- The `src` prop takes precedence over the `text` prop.

Easily use one of [BootstrapVue's icons](/docs/icons) as the avatar content via the `icon` prop. The

prop should be set to a valid icon name. Icons will scale respective to the [`size` prop](#sizing).

<template>

<div class="mb-2">

<b-avatar icon="people-fill"></b-avatar>

<b-avatar icon="star-fill"></b-avatar>

<b-avatar icon="music-note"></b-avatar>

<b-avatar icon="star-fill" size="4em"></b-avatar>

</div>

</template>

**Notes:**

- When providing a BootstrapVue icon name, you _must_ ensure that you have registered the

corresponding icon component (either locally to your component/page, or globally), if not using

the full [`BootstrapVueIcons` plugin](/docs/icons).

- The `icon` prop takes precedence over the `text` and `src` props.

- If the `text`, `src`, or `icon` props are not provided _and_ the [default slot](#custom-content)

has no content, then the `person-fill` icon will be used.

Use the `default` slot to render custom content in the avatar, for finer grained control of its

appearance, or if using custom icons or SVGs e.g.:

<b-avatar><custom-icon></custom-icon></b-avatar>

**Notes:**

- The default slot takes precedence over the `text`, `src` and `icon` props.

- The default slot content will be wrapped in a `<span>` element to ensure proper centering.

- You may need additional styling applied to the custom content to compensate for the

[shape of avatar component](#rounding).

Use the `variant` prop to specify one of Bootstrap theme variant colors. The default variant is

`secondary`.

<template>

<div>

<b-avatar variant="secondary"></b-avatar>

<b-avatar variant="primary"></b-avatar>

<b-avatar variant="dark"></b-avatar>

<b-avatar variant="light"></b-avatar>

<b-avatar variant="success"></b-avatar>

<b-avatar variant="danger"></b-avatar>

<b-avatar variant="warning"></b-avatar>

<b-avatar variant="info"></b-avatar>

</div>

</template>

If you have defined additional custom variants via

[SASS theming variables](/docs/reference/theming), the custom variants will also be available to

use.

By default, avatars are sized to `2.5em` (which is relative to the current font size). You can

change the size of the avatar by changing the current font size, or use the prop `size` to specify

an explicit size. The sizes `sm`, `md` and `lg` default to `1.5em`, `2.5em` and `3.5em`. Numbers get

converted to pixel values. Any other value _must_ include the units (such as `px`, `em`, or `rem`).

<template>

<div>

<b-avatar></b-avatar>

<b-avatar size="sm"></b-avatar>

<b-avatar size="lg"></b-avatar>

<b-avatar :size="24"></b-avatar>

<b-avatar size="3em"></b-avatar>

<b-avatar size="72px"></b-avatar>

</div>

</template>

**Note:** Avatars are _always_ rendered with an aspect ratio of `1:1`.

Prefer a square avatar? simply set the `square` prop to `true`.

<template>

<div>

<b-avatar square></b-avatar>

</div>

</template>

`<b-avatar>` renders with a circular border radius. You can change the rounding by setting the prop

`rounded` to one of the values `true`, `'sm'`, `'lg'`, `'top'`, `'left'`, `'right'`, or `'bottom'`.

When set to `true` (or the empty string `''`), it uses the Bootstrap default of medium rounding.

<template>

<div style="font-size: 2rem;">

<b-avatar rounded="sm"></b-avatar>

<b-avatar rounded></b-avatar>

<b-avatar rounded="lg"></b-avatar>

<b-avatar rounded="top"></b-avatar>

<b-avatar rounded="left"></b-avatar>

<b-avatar rounded="right"></b-avatar>

<b-avatar rounded="bottom"></b-avatar>

</div>

</template>

**Notes:**

- The `square` prop takes precedence over the `rounded` prop.

- Alternatively to to the `square` prop, you can set the `rounded` prop to the string `'0'` to

achieve a square avatar.

By default `<b-avatar>` will be vertically centered with its adjoining content. In some cases you

may want to alter the alignment, such as ensuring that a text-only avatar aligns its text with the

adjoining text. Simply set a [vertical alignment utility](/docs/reference/utility-classes) class on

the component, such as `<b-avatar class="align-baseline" ...>` or

`<b-avatar class="align-top" ...>`, etc.

Easily create avatars that respond to clicks, or avatars that change the URL/route when clicked.

Actionable avatars will appear in the document tab sequence, and are accessible for both screen

reader and keyboard-only users.

Want to trigger the opening of a modal or trigger an action? Set the `button` prop to instruct

`<b-avatar>` to render as a `<button>` element. When rendered as a button, the component will emit

the `click` event whenever clicked.

<template>

<div>

<b-avatar button @click="onClick" variant="primary" text="FF" class="align-baseline"></b-avatar>

Button Avatar

</div>

</template>

<script>

</script>

The prop `button-type` can be used to control the type of button to render. Supported values are

`'button'` (the default), `'submit'`, or `'reset'`.

Fancy an avatar as a link or router link? Simply set either the `href` or `to` props (respectively).

The `to` prop can either be a string path, or a `Location` object. The `to` prop requires that

`Vue router` (or equivalent) be installed.

<template>

<div>

<b-avatar href="#foobar"variant="info" src="https://placekitten.com/300/300"></b-avatar>

Link Avatar

</div>

</template>

**Note:**

- The `button` prop takes precedence over the `href` and `to` props.

- For additional details on the `<router-link>` compatible props, please refer to the

[Router support reference section](/docs/reference/router-links).

Use the `aria-label` prop to provide an accessible, screen reader friendly, label for your avatar.

While the `click` event is emitted regardless if the `button`, `href`, or `to` props are set, it is

highly recommended to use the `button` prop when the click event should trigger an action (or use

the `to` or `href` props when changing routes or changing URLs) for accessibility reasons.

Avatars are based upon `<b-badge>` and `<b-button>` components, and as such, rely upon Bootstrap's

`badge-*` and `btn-*` variant classes, as well as the `rounded-*`

[utility classes](/docs/reference/utility-classes).

`<b-avatar>` also requires BootstrapVue's custom CSS for proper styling.