Spinner

En pocas palabras

Un círculo que gira y dice “espera, estoy en ello”.

Un arco que gira. Su ángulo sale del reloj de la app, así que mantén una suscripción como pz.every(1 / 30, ...) mientras se muestra o no se moverá.

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

Vista previa

Código

pz.row([
    ui.spinner(),
    ui.spinner(size=24, tint="success"),
    pz.row([ui.spinner(size=14), ui.muted("Indexing project…")], spacing=8, align="center"),
], spacing=24, align="center")

Cuándo usarlo

• Para esperas cortas de duración desconocida: conectando, buscando, cargando un archivo.
• Para trabajos largos con avance conocido usa Progreso.

Uso

import pyzed as pz
from pyzed import ui

class Loader(pz.App):
    def __init__(self):
        self.loading = True

    def subscription(self):
        return pz.every(1 / 30, lambda: None) if self.loading else None

    def view(self):
        return ui.spinner() if self.loading else ui.label("Done")

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.

Tamaño

size=12

Código

ui.spinner(size=12)

size=16

Código

ui.spinner()

size=24

Código

ui.spinner(size=24)

size=36

Código

ui.spinner(size=36)

Tinte

tint="success"

Código

ui.spinner(size=24, tint="success")

tint="warning"

Código

ui.spinner(size=24, tint="warning")

tint="text_muted"

Código

ui.spinner(size=24, tint="text_muted")

Con texto

En línea

Código

pz.row([ui.spinner(size=14), ui.muted("Indexing project…")], spacing=8, align="center")

En un botón

Código

ui.button(pz.row([ui.spinner(size=12, tint="text"), pz.text("Saving")], spacing=6, align="center"))

Eventos

Spinner 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.spinner

spinner(*, size=16, tint='accent', speed=1.0, theme=None)

Un arco que gira para estados de carga. Su ángulo sale del reloj, así que mantén una suscripción pz.every(1/30, ...) activa mientras se muestra.

Propiedad	Por defecto	Descripción
size	16	Tamaño.
tint	"accent"	Color semántico: "accent", "error", "warning", "success", "info" o un token.
speed	1.0	Vueltas por segundo.
theme	None	Tema a usar en lugar del actual (pyzed.theme.current()).

Referencia completa →

Relacionados

ProgresoUna barra de progreso fina en un color semántico.

Estado vacíoUn marcador centrado para listas y búsquedas vacías.