# Facepile

> Avatares de colaboradores superpuestos con +N. Un componente nativo de Pyzed para GUIs de escritorio en Python, con vista previa, ejemplos y su API.

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

:::tip[En pocas palabras]
Una fila de avatares superpuestos que muestra quién está.
:::

Avatares superpuestos de colaboradores, como en la barra de título de un editor colaborativo. Los que pasan de `max_shown` se agrupan en `+N`.

`ui.facepile` · Categoría: [Datos](https://albakore.github.io/pyzed/es/library/#datos) · [Referencia completa →](https://albakore.github.io/pyzed/es/reference/ui/#facepile)

**Código:**

```python
pz.column([
    ui.facepile(["Ana", "Luis", "Kev", "Marta"]),
    ui.facepile(["Ana", "Luis", "Kev", "Marta", "Sam", "Jo", "Lee", "Max"], size=28, max_shown=4),
], spacing=16, align="center")
```

## Cuándo usarlo

- Para mostrar quién está en un proyecto, una llamada o un documento sin listar los nombres.

## Uso

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

pz.column([
    ui.facepile(["Ana", "Luis", "Kev", "Marta"]),
    ui.facepile(["Ana", "Luis", "Kev", "Marta", "Sam", "Jo", "Lee", "Max"], size=28, max_shown=4),
], spacing=16, 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.
:::

### Opciones

```python
ui.facepile(["Ana", "Luis"])
```

```python
ui.facepile(["Ana", "Luis", "Kev", "Marta", "Sam"])
```

```python
ui.facepile(["Ana", "Luis", "Kev", "Marta", "Sam", "Jo", "Lee"], max_shown=3)
```

```python
ui.facepile(["Ana", "Luis", "Kev", "Marta"], size=32, overlap=10)
```

## Eventos

Facepile 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.facepile`

```python
facepile(people, *, size=22, overlap=6, max_shown=5, theme=None)
```

Avatares superpuestos de colaboradores, como en la barra de título de un editor colaborativo. Los que pasan de `max_shown` se agrupan en `+N`.

| Propiedad | Por defecto | Descripción |
| --- | --- | --- |
| `people` | *obligatorio* | Iniciales o nombres. |
| `size` | `22` | Tamaño. |
| `overlap` | `6` | Solapamiento en píxeles. |
| `max_shown` | `5` | Cuántos mostrar. |
| `theme` | `None` | Tema a usar en lugar del actual (`pyzed.theme.current()`). |

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

## Relacionados

- [Avatar](https://albakore.github.io/pyzed/es/library/avatar/): Un avatar redondo con iniciales en un color de colaborador.
- [Barra de título](https://albakore.github.io/pyzed/es/library/title-bar/): La barra superior con los selectores de proyecto y rama.