Cabecera de lista

En pocas palabras

Un título pequeño encima de un grupo de filas.

Una cabecera de sección discreta para listas, con un widget opcional al final (normalmente un botón de icono).

ui.list_header · Categoría: Listas y menús · Referencia completa →

Vista previa

Código

pz.column([
    ui.list_header("RECENT", end=ui.icon_button("plus", on_new, size="xs")),
    ui.list_item("main.py", on_open, icon="file-code", inset=True),
    ui.list_item("app.py", on_open, icon="file-code", inset=True),
    ui.list_header("PINNED"),
    ui.list_item("README.md", on_open, icon="file-text", inset=True),
], width=300)

Cuándo usarlo

• Para dividir una lista en grupos (RECIENTES, FIJADOS) o añadirle una acción.

Uso

import pyzed as pz
from pyzed import ui

pz.column([
    ui.list_header("RECENT", end=ui.icon_button("plus", on_new, size="xs")),
    ui.list_item("main.py", on_open, icon="file-code", inset=True),
    ui.list_item("app.py", on_open, icon="file-code", inset=True),
    ui.list_header("PINNED"),
    ui.list_item("README.md", on_open, icon="file-text", inset=True),
], width=300)

Variantes

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

Título

Código

pz.container(ui.list_header("RECENT"), width=240)

end=

Código

pz.container(ui.list_header("PINNED", end=ui.icon_button("plus", on_new, size="xs")), width=240)

Contador al final

Código

pz.container(ui.list_header("CHANGES", end=ui.count_badge(4)), width=240)

Eventos

Cabecera de lista 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 y Eventos de cada componente.

Propiedades y API

ui.list_header

list_header(title, *, end=None, theme=None)

Un encabezado de sección para listas.

Propiedad	Por defecto	Descripción
title	obligatorio	Título.
end	None	Widgets al final (derecha).
theme	None	Tema a usar en lugar del actual (pyzed.theme.current()).

Referencia completa →

Relacionados

Fila de listaUna fila de lista con icono, texto y un hueco al final.

Cabecera de panelIcono, título y acciones encima de un dock.