# Encabezado

> Títulos en seminegrita en tres niveles. 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/heading/

:::tip[En pocas palabras]
Un título: texto más grande y en negrita que nombra una página o una sección.
:::

Un título en seminegrita. `level=1` (por defecto), `2` o `3` eligen el tamaño, así los títulos son coherentes en todas las pantallas.

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

**Código:**

```python
pz.column([
    ui.heading("Heading 1"),
    ui.heading("Heading 2", level=2),
    ui.heading("Heading 3", level=3),
    ui.muted("Body text below the headings."),
], spacing=6)
```

## Cuándo usarlo

- Para el título de una página, una sección de un diálogo o un grupo de ajustes.
- Para un título pequeño de lista en mayúsculas, usa [Cabecera de lista](https://albakore.github.io/pyzed/es/library/list-header/).

## Uso

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

pz.column([
    ui.heading("Heading 1"),
    ui.heading("Heading 2", level=2),
    ui.heading("Heading 3", level=3),
    ui.muted("Body text below the headings."),
], spacing=6)
```

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

### Nivel

```python
ui.heading("Project settings")
```

```python
ui.heading("Project settings", level=2)
```

```python
ui.heading("Project settings", level=3)
```

```python
ui.heading("Project settings", level=4)
```

### Color

```python
ui.heading("Welcome back", level=2, color="accent")
```

```python
pz.column([ui.heading("Billing", level=2), ui.muted("Invoices and payment methods.")], spacing=4)
```

## Eventos

Encabezado 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.heading`

```python
heading(content, *, level=1, theme=None, **kwargs)
```

Un título en semibold.

| Propiedad | Por defecto | Descripción |
| --- | --- | --- |
| `content` | *obligatorio* | Contenido: un `Widget`, un texto o un número (se convierte en texto). |
| `level` | `1` | 1 (26 px), 2 (20 px), 3 (16 px) o 4 (13.5 px). |
| `theme` | `None` | Tema a usar en lugar del actual (`pyzed.theme.current()`). |
| `**kwargs` | — | Los de `label`. |

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

## Relacionados

- [Etiqueta](https://albakore.github.io/pyzed/es/library/label/): Texto con color, tamaño y peso del tema; `muted` para texto secundario.
- [Tarjeta](https://albakore.github.io/pyzed/es/library/card/): Una superficie con borde, título y acciones opcionales.