Vue3-avatar NPM

vue3-avatar

A user avatar component for vue3. By default it uses light colors for Text and dark colors for Background.

This component is highly inspired from vue-avatar.

This component computes the Initials from provided name with following rules:

Splits the name by spaces and hyphens.
Finds the first letter of each parts.
Maximum length of Avatar letters is 3.
If the name is splitted into more than 2 parts then picks the first letter of part1, part2 and last part.

This component can now also show an image by setting the imageSrc prop. If an error occurs in fetching the image from the provided source, the component falls back to Initials.

Examples

Tony will become T
Tony Stark will become TS
Tony Howard-Stark will become THS
Albert Tony Howard Stark will become ATS

Preview

Installation

npm install vue3-avatar

Usage

vue3-avatar is very easy to use.

ES6

For Local Registration

import Avatar from "vue3-avatar";

export default {
    ...
    components : {
        Avatar,
        ...
    },
    ...
}

For Global Registration

Update main.js

import { createApp } from "vue";
import App from "./App.vue";
...
import Avatar from "vue3-avatar";

createApp(App).component("avatar", Avatar)
...

After importing the component, you can use it in your templates as:

<avatar name="John Doe"></avatar>

Props

Property	Required	Type	Default	Decription
name	true	String	-	Name to compute Avatar letters
color	false	String	white	Text color for Avatar letters
background	false	String	navy	Background color for Avatar
size	false	Number	40	Pixel size for Avatar (Same Height and Width)
inverted	false	Boolean	false	To Invert the text color with Background color
inline	false	Boolean	false	To create inline Avatar
rounded	false	Boolean	true	Square or Rounded
imageSrc	false	String	null	To show an Image
border	false	Boolean	true	Show or Hide the border
borderColor	false	String	white	Border color for avatar
status	false	String	white	To set user status as "online", "away", "offline", or "busy"
sameBorder	false	Boolean	false	To have same border in Avatar as well as Status Indicator
customAvatarStyle	false	Object	{}	A custom style object to personalize the avatar apperance
customStatusStyle	false	Object	{}	A custom style object to personalize the status indicator