Grupo de ajustes

En pocas palabras

Un bloque de ajustes con título, como una sección de una ventana de preferencias.

Un bloque con título de filas ui.field separadas por líneas, con una descripción opcional, como una pantalla de ajustes.

ui.settings_group · Categoría: Datos · Referencia completa →

Vista previa

Código

pz.container(ui.settings_group("Editor", [
    ui.field("Font size", ui.number_field(14, on_change, suffix="px")),
    ui.field("Soft wrap", ui.switch(True, on_toggle)),
    ui.field("Theme", ui.select(["One Dark", "One Light"], "One Dark", on_select, width=150)),
], description="Editor preferences."), width=460)

Cuándo usarlo

• Para organizar una pantalla de preferencias en secciones (Editor, Archivos, Git…).

Uso

import pyzed as pz
from pyzed import ui

pz.container(ui.settings_group("Editor", [
    ui.field("Font size", ui.number_field(14, on_change, suffix="px")),
    ui.field("Soft wrap", ui.switch(True, on_toggle)),
    ui.field("Theme", ui.select(["One Dark", "One Light"], "One Dark", on_select, width=150)),
], description="Editor preferences."), width=460)

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

Sin descripción

Código

pz.container(ui.settings_group("Files", [
    ui.field("Autosave", ui.switch(True, on_toggle)),
    ui.field("Trim whitespace", ui.checkbox(False, on_toggle)),
]), width=380)

description=

Código

pz.container(ui.settings_group("Git", [
    ui.field("Inline blame", ui.switch(False, on_toggle)),
], description="Shown in the editor gutter."), width=380)

Estados y eventos

end=

Código

pz.container(ui.settings_group("Editor", [ui.field("Wrap lines", ui.switch(True, on_toggle))],
                               end=ui.button("Reset", on_press, size="sm", variant="ghost")), width=420)

Eventos

Grupo de ajustes 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.settings_group

settings_group(title, rows, *, description=None, end=None, theme=None)

Un bloque con título de filas ui.field separadas por líneas, como una pantalla de ajustes.

Propiedad	Por defecto	Descripción
title	obligatorio	Título del grupo.
rows	obligatorio	Las filas (normalmente ui.field).
description	None	Texto secundario.
end	None	Widget a la derecha del título (un botón Restablecer…).
theme	None	Tema a usar en lugar del actual (pyzed.theme.current()).

Referencia completa →

Relacionados

Campo de formularioUna fila de ajustes: título y descripción a la izquierda, control a la derecha.

AcordeónSecciones plegables apiladas, como los paneles de una pantalla de ajustes.

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