# Cabecera de panel

> Icono, título y acciones encima de un dock. 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/panel-header/

:::tip[En pocas palabras]
La fila de título de un panel lateral, con sus botones.
:::

La cabecera de un dock o panel: un icono opcional, el título y botones de acción a la derecha.

`ui.panel_header` · Categoría: [Espacio de trabajo](https://albakore.github.io/pyzed/es/library/#espacio-de-trabajo) · [Referencia completa →](https://albakore.github.io/pyzed/es/reference/ui/#panel_header)

**Código:**

```python
pz.column([
    ui.panel_header("Project", [ui.icon_button("plus", on_new, size="xs"),
                                ui.icon_button("ellipsis", on_menu, size="xs")]),
    ui.panel_header("Terminal", [ui.icon_button("x", on_close, size="xs")], icon="terminal"),
], spacing=12, width=320)
```

## Cuándo usarlo

- Arriba de cada dock (Proyecto, Esquema, Terminal) para nombrarlo y poner sus acciones.

## Uso

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

pz.column([
    ui.panel_header("Project", [ui.icon_button("plus", on_new, size="xs"),
                                ui.icon_button("ellipsis", on_menu, size="xs")]),
    ui.panel_header("Terminal", [ui.icon_button("x", on_close, size="xs")], icon="terminal"),
], spacing=12, width=320)
```

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

### Contenido

```python
pz.container(ui.panel_header("Project"), width=280)
```

```python
pz.container(ui.panel_header("Terminal", icon="terminal"), width=280)
```

```python
pz.container(ui.panel_header("Project", [ui.icon_button("plus", on_new, size="xs"),
                                     ui.icon_button("ellipsis", on_menu, size="xs")]), width=280)
```

```python
pz.container(ui.panel_header("Outline", height=40), width=280)
```

## Eventos

Cabecera de panel 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.panel_header`

```python
panel_header(title, actions=(), *, icon=None, height=32, theme=None)
```

La cabecera de un panel: icono, título y acciones.

| Propiedad | Por defecto | Descripción |
| --- | --- | --- |
| `title` | *obligatorio* | Título. |
| `actions` | `()` | Widgets extra (normalmente botones) que se muestran como acciones. |
| `icon` | `None` | Nombre de un icono de Lucide (`pyzed icons` los lista). |
| `height` | `32` | Alto. |
| `theme` | `None` | Tema a usar en lugar del actual (`pyzed.theme.current()`). |

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

## Relacionados

- [Panel](https://albakore.github.io/pyzed/es/library/panel/): Un panel lateral acoplable y redimensionable.
- [Cabecera de lista](https://albakore.github.io/pyzed/es/library/list-header/): Un título pequeño de sección para listas, con hueco al final.