Avatar

An image element with a fallback for representing the user.

PreviousNext
ZAZAJDSALU
Loading...

Installation

1

Run the CLI

Use the CLI to add the component to your project.

Loading...
1

Add the component files

Create the component directory structure and add the following files to your project.

Loading...

Examples

basic

ZAZAJDSALU
import { Component } from '@angular/core';
 
import { ZardAvatarGroupComponent } from '../avatar-group.component';
import { ZardAvatarComponent } from '../avatar.component';
 
@Component({
  selector: 'z-demo-avatar-basic',
  standalone: true,
  imports: [ZardAvatarComponent, ZardAvatarGroupComponent],
  template: `
    <z-avatar zSrc="/images/avatar/imgs/avatar_image.jpg" zFallback="ZA" [zSize]="32" />
    <z-avatar zSrc="error-image.png" zFallback="ZA" zSize="sm" />
 
    <z-avatar-group>
      <z-avatar zSrc="/images/avatar/imgs/avatar_image.jpg" zFallback="JD" zSize="sm" />
      <z-avatar zSrc="https://github.com/srizzon.png" zFallback="SA" zSize="sm" />
      <z-avatar zSrc="https://github.com/Luizgomess.png" zFallback="LU" zSize="sm" />
    </z-avatar-group>
  `,
})
export class ZardDemoAvatarBasicComponent {}
 

status

import { Component } from '@angular/core';
 
import { ZardAvatarComponent } from '../avatar.component';
 
@Component({
  selector: 'z-demo-avatar-status',
  standalone: true,
  imports: [ZardAvatarComponent],
  template: `
    <z-avatar zSrc="/images/avatar/imgs/avatar_image.jpg" zAlt="Image" />
    <z-avatar zStatus="online" zSrc="/images/avatar/imgs/avatar_image.jpg" zAlt="Image" />
    <z-avatar zStatus="offline" zSrc="/images/avatar/imgs/avatar_image.jpg" zAlt="Image" />
    <z-avatar zStatus="doNotDisturb" zSrc="/images/avatar/imgs/avatar_image.jpg" zAlt="Image" />
    <z-avatar zStatus="away" zSrc="/images/avatar/imgs/avatar_image.jpg" zAlt="Image" />
  `,
})
export class ZardDemoAvatarStatusComponent {}
 

API Reference

z-avatar Component

Property Description Type Default
[zSize] Avatar size variant sm | default | md | lg | xl | number default
[zShape] Avatar shape circle | rounded | square circle
[zStatus] Status indicator badge online | offline | doNotDisturb | away
[zSrc] Image source URL string
[zAlt] Image alt text for accessibility string ''
[zFallback] Fallback text displayed while loading or on error string ''
[class] Additional CSS classes string ''

z-avatar-group Component

Property Description Type Default
[zOrientation] Layout direction of avatars horizontal | vertical horizontal
[class] Additional CSS classes string ''