Estado vacío

En pocas palabras

Lo que muestra una pantalla cuando aún no tiene nada, con una pista de qué hacer después.

Un icono, un título, una descripción y acciones centrados para un lugar que aún no tiene nada que mostrar.

ui.empty_state · Categoría: Estado y avisos · Referencia completa →

Vista previa

Código

ui.empty_state("No results", "Try a different search.", icon="search",
               actions=[ui.button("Clear filters", on_clear, size="sm")])

Cuándo usarlo

• Para una lista vacía, una búsqueda sin resultados o un panel antes de abrir el primer archivo.
• Ofrece el siguiente paso como acción (Crear, Quitar filtros, Abrir carpeta).

Uso

from pyzed import ui

ui.empty_state("No results", "Try a different search.", icon="search",
               actions=[ui.button("Clear filters", on_clear, size="sm")])

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.

Contenido

Solo título

Código

ui.empty_state("No notifications")

Con descripción

Código

ui.empty_state("No results", "Try a different search.", icon="search")

actions=

Código

ui.empty_state("No projects yet", "Create one to get started.", icon="folder-plus",
               actions=[ui.button("New project", on_new, variant="solid", size="sm")])

Estados y eventos

size="sm", height="shrink"

Código

ui.empty_state("No results", "Try another search", icon="search", size="sm", height="shrink")

size="lg"

Código

ui.empty_state("No projects", "Create one to start", icon="folder", size="lg", height=220)

Eventos

Estado vacío 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.empty_state

empty_state(
    title,
    description=None,
    *,
    icon='inbox',
    actions=(),
    size='md',
    height='fill',
    theme=None,
)

Un marcador centrado para listas vacías, búsquedas sin resultados, etc.

Propiedad	Por defecto	Descripción
title	obligatorio	Título.
description	None	Texto secundario.
icon	"inbox"	Nombre de un icono de Lucide (pyzed icons los lista).
actions	()	Widgets extra (normalmente botones) que se muestran como acciones.
size	"md"	"sm", "md" o "lg".
height	"fill"	"fill" (por defecto), píxeles o "shrink".
theme	None	Tema a usar en lugar del actual (pyzed.theme.current()).

Referencia completa →

Relacionados

AvisoUn aviso en línea con título, texto y acciones.

Pista de atajoUna pista discreta tipo “Abrir archivo Ctrl P”.

TarjetaUna superficie con borde, título y acciones opcionales.