# Avatar

> Un avatar redondo con iniciales en un color de colaborador. Componente de Pyzed para GUIs de escritorio en Python, con ejemplos y API.

Source: https://albakore.github.io/pyzed/es/library/avatar/

:::tip[En pocas palabras]
Un círculo con las iniciales de alguien, en su propio color.
:::

Un círculo con iniciales. `index` elige uno de los colores de colaborador (player) del tema, así la misma persona conserva su color; `color` lo fija directamente.

`ui.avatar` · Categoría: [Visualización](https://albakore.github.io/pyzed/es/library/#visualización) · [Referencia completa →](https://albakore.github.io/pyzed/es/reference/ui/#avatar)

**Código:**

```python
pz.row([
    ui.avatar("AL", index=0),
    ui.avatar("KV", index=1),
    ui.avatar("MZ", index=2, size=28),
    ui.avatar("JD", index=3, size=36),
], spacing=8, align="center")
```

## Cuándo usarlo

- Para la cuenta en la barra de título, autores de comentarios o colaboradores.
- Para varias personas a la vez usa [Facepile](https://albakore.github.io/pyzed/es/library/facepile/).

## Uso

```python
import pyzed as pz
from pyzed import ui

pz.row([
    ui.avatar("AL", index=0),
    ui.avatar("KV", index=1),
    ui.avatar("MZ", index=2, size=28),
    ui.avatar("JD", index=3, size=36),
], spacing=8, align="center")
```

## Variantes

:::note[Sobre estas capturas]
Cada captura la graba pyzed mismo, fuera de pantalla a 2x, en One Dark o One Light según el tema de este sitio, y recortada al componente para que se vea a su tamaño real. El puntero pasa por encima, pulsa o escribe en él; un componente que no reacciona al puntero recorre algunos temas. Con movimiento reducido ves el primer fotograma. Abre **Código** bajo una captura para ver el fragmento que la dibuja; los nombres libres como `on_save` son tus propios callbacks.
:::

### Color de colaborador

```python
ui.avatar("AL", index=0)
```

```python
ui.avatar("KV", index=1)
```

```python
ui.avatar("MZ", index=2)
```

```python
ui.avatar("JD", index=3)
```

```python
ui.avatar("SR", index=4)
```

```python
ui.avatar("PB", index=5)
```

### Tamaño

```python
ui.avatar("KV", size=18)
```

```python
ui.avatar("KV", size=22)
```

```python
ui.avatar("KV", size=32)
```

```python
ui.avatar("KV", size=48)
```

### Color

```python
ui.avatar("PZ", color="#c678dd", size=32)
```

```python
ui.avatar("UI", color="#e5c07b", size=32)
```

### Estados y eventos

`image=` muestra una foto en lugar de las iniciales y `tooltip=` nombra a la persona al pasar el ratón.

```python
ui.avatar("KK", status="online", size=32)
```

```python
ui.avatar("AL", status="away", index=2, size=32)
```

```python
ui.avatar("MZ", status="busy", index=4, size=32)
```

## Eventos

Avatar no tiene eventos propios: muestra lo que le das. Como todo widget, también tiene los **18 eventos comunes** (`click`, `double_click`, `right_click`, `mouse_enter`, `drag`, `key_down`, `resize`…), que se conectan con `.on(...)`: mira [Eventos](https://albakore.github.io/pyzed/es/guides/events/) y [Eventos de cada componente](https://albakore.github.io/pyzed/es/library/events/).

## Propiedades y API

### `ui.avatar`

```python
avatar(
    initials,
    *,
    color=None,
    size=22,
    index=0,
    image=None,
    status=None,
    tooltip=None,
    theme=None,
)
```

Un avatar redondo con iniciales.

| Propiedad | Por defecto | Descripción |
| --- | --- | --- |
| `initials` | *obligatorio* | Iniciales (se usan las dos primeras). |
| `color` | `None` | Color de fondo. |
| `size` | `22` | Diámetro. |
| `index` | `0` | Elige un color de colaborador del tema (`theme.players`). |
| `image` | `None` | Una imagen (ruta o bytes) en lugar de las iniciales. |
| `status` | `None` | Punto de presencia: `"online"`, `"away"`, `"busy"`, `"offline"` o un color. |
| `tooltip` | `None` | Texto al pasar el ratón (el nombre de la persona). |
| `theme` | `None` | Tema a usar en lugar del actual (`pyzed.theme.current()`). |

[Referencia completa →](https://albakore.github.io/pyzed/es/reference/ui/#avatar)

## Relacionados

- [Facepile](https://albakore.github.io/pyzed/es/library/facepile/): Avatares de colaboradores superpuestos con +N.
- [Barra de título](https://albakore.github.io/pyzed/es/library/title-bar/): La barra superior con los selectores de proyecto y rama.