Color Dialog

bs.ask_color() opens a modal color chooser and returns the selected color. ColorChooserDialog gives the same chooser as a reusable object.

Usage

Reach for the ask_color() verb by default — it covers the one-shot case. Drop to the ColorChooserDialog object only when you need to reuse the chooser or open it repeatedly.

Convenience function

bs.ask_color() is the one-liner shorthand. Pass value= to pre-select an initial color (any CSS hex string):

result = bs.ask_color(title="Background Color", value="#1a1a2e")
if result:
    apply_background(result.hex)

The return value is a ColorChoice with three attributes:

Attribute	Description
rgb	(r, g, b) tuple, each 0–255.
hsl	(h, s, l) tuple: hue 0–360, saturation and luminance 0–100.
hex	Lowercase hex string, e.g. '#0070c0'.

None is returned if the user cancels.

Reusable dialog object

Use ColorChooserDialog when you need to inspect the result after show() or show the same dialog multiple times:

from bootstack.dialogs import ColorChooserDialog

dlg = ColorChooserDialog(title="Pick a color", value="#ff0000")
dlg.show()

if dlg.result:
    r, g, b = dlg.result.rgb

Chooser layout

The chooser has two tabs. Themed shows the active theme’s color families (primary, success, info, warning, danger, and a neutral gray) as light-to-dark bands — click any swatch to pick an on-theme color. Custom shows a hue/saturation field for picking any color freely. Both tabs share the luminance slider, live preview, and the numeric fields on the right, which allow direct entry in RGB, HSL, or hex notation.

See also

Input Dialogs — ask_string(), ask_integer(), and other value-input dialogs.

Font Dialog — ask_font() for selecting a font.

API

The complete reference for ask_color() and ColorChooserDialog (and its ColorChoice result) lives on the Dialogs API page. At a glance:

ask_color	Show a color chooser dialog.
ColorChooserDialog	A dialog for choosing a color.
ColorChoice	A color selected from ColorChooserDialog or ask_color.

Full Example

from bootstack.dialogs import ColorChooserDialog
def show_chooser():
    result = bs.ask_color(title="Choose Color", value="#0070C0")
    if result:
        print(f"Selected: hex={result.hex}  rgb={result.rgb}  hsl={result.hsl}")

def show_custom():
    dlg = ColorChooserDialog(title="Background Color", value="#00B050")
    dlg.show()
    if dlg.result:
        print(f"hex={dlg.result.hex}")

with bs.App(title="Color Dialog", size=(680, 160), padding=20, gap=16) as app:

    bs.Label("Color Dialog", font="heading-sm")
    with bs.Row(gap=8):
        bs.Button("ask_color()",          on_click=show_chooser)
        bs.Button("ColorChooserDialog()", on_click=show_custom)

app.run()