# Indicador

> Un punto de color para estado, presencia o cambios sin guardar. Componente de Pyzed para GUIs de escritorio en Python, con ejemplos y API.

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

:::tip[En pocas palabras]
Un puntito de color que indica un estado de un vistazo: verde es que va bien, rojo que hay un problema.
:::

Un punto de color pequeño. `color` es un token del tema o un color hex y `size` su diámetro.

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

**Código:**

```python
pz.column([
    pz.row([ui.indicator("success"), ui.label("Server running")], spacing=8, align="center"),
    pz.row([ui.indicator("warning"), ui.label("Reconnecting")], spacing=8, align="center"),
    pz.row([ui.indicator("error"), ui.label("Build failed")], spacing=8, align="center"),
    pz.row([ui.indicator(size=10), ui.label("Unsaved changes")], spacing=8, align="center"),
], spacing=10)
```

## Cuándo usarlo

- Junto a un nombre para mostrar presencia (conectado, ocupado) o un estado (en marcha, falló).
- En una pestaña o fila para marcar cambios sin guardar.

## Uso

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

pz.column([
    pz.row([ui.indicator("success"), ui.label("Server running")], spacing=8, align="center"),
    pz.row([ui.indicator("warning"), ui.label("Reconnecting")], spacing=8, align="center"),
    pz.row([ui.indicator("error"), ui.label("Build failed")], spacing=8, align="center"),
    pz.row([ui.indicator(size=10), ui.label("Unsaved changes")], spacing=8, align="center"),
], spacing=10)
```

## 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

```python
ui.indicator()
```

```python
ui.indicator("success")
```

```python
ui.indicator("warning")
```

```python
ui.indicator("error")
```

```python
ui.indicator("text_muted")
```

```python
ui.indicator("#c678dd")
```

### Tamaño

```python
ui.indicator("success", size=6)
```

```python
ui.indicator("success", size=10)
```

```python
ui.indicator("success", size=14)
```

### Junto a un texto

```python
pz.row([ui.indicator("success"), ui.label("Ana is online")], spacing=8, align="center")
```

```python
pz.row([ui.label("notes.py"), ui.indicator(size=8)], spacing=6, align="center")
```

## Eventos

Indicador 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.indicator`

```python
indicator(color='accent', *, size=6, theme=None)
```

Un punto de color (estado, cambios sin guardar, presencia).

| Propiedad | Por defecto | Descripción |
| --- | --- | --- |
| `color` | `"accent"` | Token o color. |
| `size` | `6` | Diámetro. |
| `theme` | `None` | Tema a usar en lugar del actual (`pyzed.theme.current()`). |

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

## Relacionados

- [Insignia](https://albakore.github.io/pyzed/es/library/badge/): Una pastilla pequeña para estados, versiones y contadores.
- [Avatar](https://albakore.github.io/pyzed/es/library/avatar/): Un avatar redondo con iniciales en un color de colaborador.