Avatar Web Components
O Avatar Ignite UI for Web Components ajuda a exibir iniciais, imagens ou ícones em seu aplicativo.
Web Components Icon Avatar Example
Usage
Primeiro, você precisa instalar o pacote npm Ignite UI for Web Components executando o seguinte comando:
npm install igniteui-webcomponents
import { defineComponents, IgcAvatarComponent } from 'igniteui-webcomponents';
defineComponents(IgcAvatarComponent);
Para uma introdução completa ao Ignite UI for Web Components, leia o tópico Introdução.
O IgcAvatarComponent
é capaz de exibir imagens, iniciais ou qualquer outro conteúdo, incluindo ícones. Declarar um IgcAvatarComponent
é tão simples quanto:
<igc-avatar></igc-avatar>
O avatar tem vários atributos que permitem renderizar conteúdo diferente com base no contexto. A maneira mais básica de exibir conteúdo nos limites do avatar é fornecer conteúdo entre as tags de abertura e fechamento.
<igc-avatar>
<igc-icon name="home"></igc-icon>
</igc-avatar>
Initials
Se o atributo initials
estiver definido, todos os elementos filhos do avatar serão ignorados e a string passada para esse atributo será exibida.
<!-- Initials("AZ") will be displayed instead of the icon. -->
<igc-avatar initials="AZ">
<igc-icon name="home"></igc-icon>
</igc-avatar>
Image
O avatar também pode exibir uma imagem quando o atributo src
recebe uma URL válida para um ativo estático. Nesse caso, o valor initials
será ignorado e os elementos filhos não serão renderizados.
<igc-avatar
initials="AZ"
src="https://pt-br.infragistics.com/angular-demos/assets/images/men/1.jpg"
alt="A photo of a man.">
<igc-icon name="home"></igc-icon>
</igc-avatar>
Shape
O avatar suporta três formas -circle
, rounded
e square
. A forma padrão do avatar é square
e pode ser alterada por meio do atributo shape
.
Tamanho
Além do formato, o tamanho do avatar também pode ser alterado utilizando a variável CSS--ig-size
. Os tamanhos suportados são small
(padrão), medium
e large
. O seguinte trecho de código mostra como usar um tamanho de componente diferente:
igc-avatar {
--ig-size: var(--ig-size-large);
}
Styling
The IgcAvatarComponent
component exposes several CSS parts, giving you full control over its style:
Nome | Descrição |
---|---|
base |
The base wrapper of the avatar. |
initials |
The initials wrapper of the avatar. |
image |
The image wrapper of the avatar. |
icon |
The icon wrapper of the avatar. |
igc-avatar::part(base) {
--size: 60px;
color: var(--ig-success-500-contrast);
background: var(--ig-success-500);;
border-radius: 20px;
}