Vaadin Component Factory Avatar Item

Usage no npm install needed!

<script type="module">
  import vaadinComponentFactoryVcfAvatarItem from 'https://cdn.skypack.dev/@vaadin-component-factory/vcf-avatar-item';






Install vcf-avatar-item:

npm i @vaadin-component-factory/vcf-avatar-item --save


Once installed, import it in your application:

import '@vaadin-component-factory/vcf-avatar-item';

And use it:


By default, an avatar icon is shown on the avatar component. There are three ways to change what is shown on the avatar.

  1. Provide a name attribute. An abbreviation will be created based on the provided name and will be shown instead of the avatar icon. E.g. Abbreviation for "John Doe" will be "JD".
<vcf-avatar-item name="John Doe"></vcf-avatar-item>
  1. Provide an abbr attribute. The provided abbreviation will be shown instead of the avatar icon.
<vcf-avatar-item abbr="ST"></vcf-avatar-item>

Providing abbr will override name attribute.

  1. Provide an image attribute. The provided image will be shown instead of the avatar icon. If provided, the name attribute will be used as alt attribute of the image.
<vcf-avatar-item image="https://randomuser.me/api/portraits/women/5.jpg" name="Jane Doe"></vcf-avatar-item>

Providing image will override both name and abbr attributes.

Running demo

  1. Fork the vcf-avatar-item repository and clone it locally.

  2. Make sure you have npm installed.

  3. When in the vcf-avatar-item directory, run npm install to install dependencies.

  4. Run npm start to open the demo.


To contribute to the component, please read the guideline first.


Commercial Vaadin Add-on License version 3 (CVALv3). For license terms, see LICENSE.

Vaadin collects development time usage statistics to improve this product. For details and to opt-out, see https://github.com/vaadin/vaadin-usage-statistics.