Struct ColorPicker 

pub struct ColorPicker<'a> { /* private fields */ }

A click-to-open color picker bound to a Color32.

The widget paints a compact swatch-and-hex trigger; the picker UI lives in a Popover. Configure which sub-controls the popover shows via the builder. By default the popover contains a continuous picker (saturation/value plane plus hue slider), an alpha slider, and a hex input.

Implementations

impl<'a> ColorPicker<'a>

pub fn new(id_salt: impl Hash, color: &'a mut Color32) -> Self

Create a color picker keyed by id_salt and bound to color. Defaults: continuous picker on, alpha slider on, hex input on, recents tracked, opens below the trigger.

pub fn label(self, label: impl Into<WidgetText>) -> Self

Show a label above the trigger.

pub fn palette(self, palette: impl IntoIterator<Item = Color32>) -> Self

Supply a curated palette grid above the recents row. When unset (the default) no palette is shown. Use ColorPicker::default_palette for a 30-swatch starter palette inspired by Tailwind.

pub fn palette_columns(self, n: usize) -> Self

Number of columns in the palette grid. Default: 10.

pub fn continuous(self, on: bool) -> Self

Toggle the continuous saturation/value plane and hue slider. Default: on.

pub fn alpha(self, on: bool) -> Self

Toggle the alpha slider. Default: on. Disable for opaque-only colors.

pub fn hex_input(self, on: bool) -> Self

Toggle the hex input row inside the popover. Default: on.

pub fn hex_label(self, on: bool) -> Self

Show or hide the hex string next to the swatch on the trigger button. Default: shown.

pub fn recents(self, on: bool) -> Self

Toggle the recents row. The recent picks are persisted in egui context memory keyed by the picker’s id_salt. Default: on.

pub fn recents_max(self, n: usize) -> Self

Maximum number of recent picks remembered. Default: 10.

pub fn side(self, side: PopoverSide) -> Self

Which side of the trigger the popover opens on. Default: below.

pub fn default_palette() -> Vec<Color32>

A 30-swatch curated palette: a row of neutrals, a row of cool accents, and a row of warm accents. Pass to ColorPicker::palette.

Trait Implementations

impl<'a> Debug for ColorPicker<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'a> Widget for ColorPicker<'a>

fn ui(self, ui: &mut Ui) -> Response

Allocate space, interact, paint, and return a Response.