Barra de título

La barra superior de la ventana: widgets al principio (start, selectores de proyecto y rama), un center opcional y widgets al final (end, cuenta, notificaciones). ui.title_button es el botón compacto que usa (pyzed ▾, main), con estilos chevron y muted.

ui.title_bar · Categoría: Espacio de trabajo · Referencia completa →

Vista previa
Código

ui.title_bar(
    [ui.title_button("pyzed", on_projects, chevron=True),
     ui.title_button("main", on_branches, icon="git-branch", muted=True)],
    [ui.facepile(["Ana", "Luis"]), ui.icon_button("bell", on_bell, size="sm"), ui.avatar("KV")],
    center=ui.muted("notes.py"),
)

Cuándo usarlo

Arriba de un ui.workspace, o de cualquier ventana con decorations=False.

Uso

from pyzed import ui

ui.title_bar(
    [ui.title_button("pyzed", on_projects, chevron=True),
     ui.title_button("main", on_branches, icon="git-branch", muted=True)],
    [ui.facepile(["Ana", "Luis"]), ui.icon_button("bell", on_bell, size="sm"), ui.avatar("KV")],
    center=ui.muted("notes.py"),
)

Variantes

Botones de título

Barra de título: chevron=True — `chevron=True`

muted=True, icon=

Código

ui.title_button("main", on_branches, icon="git-branch", muted=True)

Barra

Eventos

Barra de título tiene 1 evento propios, en la tabla de abajo. 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 y Eventos de cada componente.

Evento	El handler recibe	Cuándo
`on_press`	`()`	Mensaje o callable que se envía al pulsar. `None` deshabilita el control.

El handler recibe es lo que Pyzed le pasa a tu función: () es nada. Cualquier handler también puede ser un mensaje (un valor que no se puede llamar), que va a update().

Manejar los eventos

Los mismos eventos escritos de tres formas. Imperativa: métodos de la app que cambian self. Declarativa: los handlers producen mensajes y un único update() decide. Funcional: una función pura dibuja un estado inmutable y pide cambios con set_state(...). Mira Imperativo, declarativo y funcional.

class Ide(pz.App):
    def __init__(self):
        self.picking = None

    def view(self):
        return ui.title_bar([
            ui.title_button("pyzed", lambda: setattr(self, "picking", "project"), chevron=True),
            ui.title_button("main", lambda: setattr(self, "picking", "branch"), icon="git-branch", muted=True),
        ], center=ui.muted(f"Pick a {self.picking}" if self.picking else "notes.py"))

from dataclasses import dataclass


@dataclass
class Pick:
    what: str


class Ide(pz.App):
    picking = None

    def update(self, message):
        match message:
            case Pick(what):
                self.picking = what

    def view(self):
        return ui.title_bar([ui.title_button("pyzed", Pick("project"), chevron=True),
                             ui.title_button("main", Pick("branch"), icon="git-branch", muted=True)])

from dataclasses import dataclass


@dataclass(frozen=True)
class State:
    project: str = "pyzed"
    projects: tuple = ("pyzed", "notes")


def view(state, set_state):
    nxt = state.projects[(state.projects.index(state.project) + 1) % len(state.projects)]
    return ui.title_bar([ui.title_button(state.project, lambda: set_state(project=nxt), chevron=True)])

Propiedades y API

`ui.title_bar`

title_bar(start=(), end=(), *, center=None, height=34, theme=None)

La barra superior: selectores de proyecto y rama a la izquierda, cuenta y acciones a la derecha.

Propiedad	Por defecto	Descripción
`start`	`()`	Widgets al inicio (izquierda).
`end`	`()`	Widgets al final (derecha).
`center`	`None`	Widget centrado.
`height`	`34`	Alto.
`theme`	`None`	Tema a usar en lugar del actual (`pyzed.theme.current()`).

Referencia completa →

`ui.title_button`

title_button(
    content,
    on_press=None,
    *,
    icon=None,
    muted=False,
    chevron=False,
    theme=None,
)

Un botón compacto para la barra de título (pyzed ▾, main…).

Propiedad	Por defecto	Descripción
`content`	obligatorio	Texto.
`icon`	`None`	Nombre de un icono de Lucide (`pyzed icons` los lista).
`muted`	`False`	Texto atenuado.
`chevron`	`False`	Añade un ▾.
`theme`	`None`	Tema a usar en lugar del actual (`pyzed.theme.current()`).

Eventos: on_press (eventos).

Referencia completa →

Relacionados

Espacio de trabajoLa disposición de una ventana estilo editor: barra de título, docks, centro y barra de estado.

Barra de estadoLa barra inferior: diagnósticos, posición del cursor, lenguaje.

FacepileAvatares de colaboradores superpuestos con +N.

Marco de ventanaTu propia barra de título, botones de ventana y menús.