Dialogs#

One-shot dialog verbs for prompting the user, plus the reusable dialog classes behind them. The verbs — alert, confirm, toast, and the ask_* family — are on the top-level compose surface and cover the common cases in a single call. The classes live in bootstack.dialogs for when a verb isn’t enough (a custom layout, a reusable instance, or direct control over the result).

For task-oriented introductions see the Dialogs & Alerts guide and the dialog pages in the Widgets catalog.

Verbs#

Show a dialog and get the result in one call. Each centers on the active window, blocks until dismissed, and returns the user’s choice (or None on cancel).

bootstack.alert

Show a message dialog with an OK button.

bootstack.ask_color

Show a color chooser dialog.

bootstack.ask_date

Show a calendar date-picker dialog.

bootstack.ask_date_range

Show a calendar dialog for selecting a start and end date range.

bootstack.ask_directory

Show a native folder chooser and return the chosen directory.

bootstack.ask_filter

Show a multi-select filter dialog.

bootstack.ask_float

Show a float-input dialog with optional range validation.

bootstack.ask_font

Show a font selector dialog.

bootstack.ask_integer

Show an integer-input dialog with optional range validation.

bootstack.ask_item

Show a dropdown-selection dialog.

bootstack.ask_open_file

Show a native open dialog for a single file and return its path.

bootstack.ask_open_files

Show a native open dialog allowing several files.

bootstack.ask_save_file

Show a native save dialog and return the chosen path.

bootstack.ask_string

Show a text-input dialog.

bootstack.confirm

Show a confirmation dialog.

bootstack.toast

Show a passive toast that dismisses itself, and return immediately.

Dialog classes#

Construct a dialog directly for custom content, reuse, or explicit lifecycle control. ColorChoice and FontChoice are the result values returned by the color and font dialogs.

bootstack.dialogs.ColorChooserDialog

A dialog for choosing a color using a hue/saturation spectrum.

bootstack.dialogs.ColorChoice

A color selected from ColorChooserDialog or ask_color.

bootstack.dialogs.Dialog

A flexible dialog window using the builder pattern.

bootstack.dialogs.DialogButton

Specification for a dialog button.

bootstack.dialogs.FilterDialog

A dialog for selecting multiple items from a list.

bootstack.dialogs.FontChoice

A font selected from FontDialog or ask_font.

bootstack.dialogs.FontDialog

A dialog for selecting a font family, size, weight, slant, and effects.

bootstack.dialogs.FormDialog

A dialog window that embeds a Form for structured data entry.

Type aliases#

type bootstack.dialogs.SeverityToken#

Severity level for an alert or toast — 'info', 'warning', 'danger', 'success'.