Interruptor

Un interruptor de encendido y apagado con el color de acento del tema. on_toggle recibe el nuevo bool.

ui.switch · Categoría: Formularios · Referencia completa →

Vista previa
Código

pz.column([
    ui.switch(True, on_toggle, label="Autosave"),
    ui.switch(False, on_toggle, label="Vim mode"),
], spacing=12)

Cuándo usarlo

Para ajustes que se aplican en el acto (Wi-Fi, autoguardado, modo oscuro).
Ponlo a la derecha de un Campo de formulario para hacer pantallas de ajustes.

Uso

import pyzed as pz
from pyzed import ui

class Settings(pz.App):
    def __init__(self):
        self.autosave = True

    def view(self):
        return ui.switch(self.autosave, lambda on: setattr(self, "autosave", on), label="Autosave")

Variantes

Estado

Interruptor: Solo lectura (sin on_toggle) — Solo lectura (sin on_toggle)

Interruptor: Sin etiqueta — Sin etiqueta

Estados y eventos

Interruptor: disabled=True — `disabled=True`

El widget pz.* de debajo: sin tema, todos los colores y tamaños son tuyos.

Eventos

Interruptor 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	De	El handler recibe	Cuándo
`on_toggle`	`ui.switch`, `pz.toggler`	`(checked)`	Callable que recibe el nuevo `bool` (o mensaje que se envía).

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 Settings(pz.App):
    def __init__(self):
        self.autosave = True

    def set_autosave(self, on):          # on_toggle: the new state
        self.autosave = on

    def view(self):
        return pz.column([
            ui.switch(self.autosave, self.set_autosave, label="Autosave"),
            ui.label("Saving as you type" if self.autosave else "Save with Ctrl+S"),
        ], spacing=8)

from dataclasses import dataclass


@dataclass
class SetAutosave:
    on: bool


class Settings(pz.App):
    autosave = True

    def update(self, message):
        match message:
            case SetAutosave(on):
                self.autosave = on

    def view(self):
        return ui.switch(self.autosave, SetAutosave, label="Autosave")

from dataclasses import dataclass


@dataclass(frozen=True)
class State:
    autosave: bool = True


def view(state, set_state):
    return ui.switch(state.autosave, lambda on: set_state(autosave=on), label="Autosave")

Consejos

Propiedades y API

`ui.switch`

switch(
    checked,
    on_toggle=None,
    *,
    label=None,
    size='md',
    disabled=False,
    id=None,
    theme=None,
)

Un interruptor encendido/apagado.

Propiedad	Por defecto	Descripción
`checked`	obligatorio	Estado actual.
`label`	`None`	Texto de la etiqueta.
`size`	`"md"`	`"sm"`, `"md"` o `"lg"`.
`disabled`	`False`	Lo atenúa e ignora los clics.
`id`	`None`	Identificador estable para enfocarlo o desplazarlo con un `Command`.
`theme`	`None`	Tema a usar en lugar del actual (`pyzed.theme.current()`).

Eventos: on_toggle (eventos).

Referencia completa →

`pz.toggler`

toggler(
    checked,
    label=None,
    *,
    on_toggle=None,
    size=None,
    text_size=None,
    accent=None,
    bg=None,
    border_color=None,
    knob_color=None,
    color=None,
)